データ型

更新しました

APIに対するdata型ポーリングで返された結果は、以下に概説されている形式のいずれかで情報を返します。

結果ペイロード

属性

データJSONペイロードのルート構造には、次の属性があります。

名前タイプ説明
dataデータ オブジェクトのリストソースから取得したデータ。
metadataメタデータ オブジェクトデータに関連するメタdata

メタデータ

属性

名前タイプ説明
count整数data内のオブジェクトの数。

ファイル

fileデータタイプは、 filesタイプポーリングを通じてAPIからダウンロードできるファイルへの参照であるため、API全体で見られfiles

属性

名前タイプ説明
file_idAPI からファイルをリクエストするために使用される識別子。値は、現在のソースのスコープ内でのみ一意であることが保証されます。
type文字列、常にfileデータ型指定子。
nameストリング拡張子を除いたファイルの名前。
extension文字列、オプション利用可能な場合、ファイルの拡張子。
mime_type文字列、オプション利用可能な場合、ファイルの MIME タイプ。
size整数、オプション利用可能な場合、ファイルのサイズ。
checksum文字列、オプション利用可能な場合は md5 チェックサム。

{
  "file_id": "abc123",
  "type": "file",
  "name": "IMG_0003",
  "extension": "jpg",
  "mime_type": "image/jpeg",
  "size": 2505426,
}

画像

ファイルを拡張します

名前タイプ説明
file_idAPI からファイルをリクエストするために使用される識別子。値は、現在のソースのスコープ内でのみ一意であることが保証されます。
type常にimage
filenameストリングファイルの元のファイル名。このファイル名の拡張子は、ファイルの拡張子と一致する必要があります。
file_pathサービス内の他のファイルに対するファイルの相対パス。たとえば、バックアップ内のパスなどです。
width整数、オプション利用可能な場合、ファイルの幅。
height整数、オプション利用可能な場合、ファイルの高さ。

{
  "file_id": "abc123",
  "type": "image",
  "filename": "IMG_0003.JPG",
  "file_path": "Media/DCIM/100APPLE/IMG_0003.JPG",
  "name": "IMG_0003",
  "extension": "jpg",
  "mime_type": "image/jpeg",
  "width": 3000,
  "height": 2002,
  "size": 2505426,
}

ビデオ

ファイルを拡張します

名前タイプ説明
file_idAPI からファイルをリクエストするために使用される識別子。値は、現在のソースのスコープ内でのみ一意であることが保証されます。
type常にvideo
filenameストリングファイルの元のファイル名。このファイル名の拡張子は、ファイルの拡張子と一致する必要があります。
file_pathサービス内の他のファイルに対するファイルの相対パス。たとえば、バックアップ内のパスなどです。
width整数、オプション利用可能な場合、ファイルの幅。
height整数、オプション利用可能な場合、ファイルの高さ。
duration整数、オプション利用可能な場合、ビデオの長さ。

{
  "file_id": "abc123",
  "type": "video",
  "filename": "IMG_0009.MOV",
  "file_path": "Media/DCIM/100APPLE/IMG_0009.MOV",
  "name": "IMG_0009",
  "extension": "mov",
  "mime_type": "video/quicktime",
  "width": 1920,
  "height": 1080,
  "size": 5421796,
  "duration": 9.135623
}

ビデオ

ファイルを拡張します

名前タイプ説明
file_idAPI からファイルをリクエストするために使用される識別子。値は、現在のソースのスコープ内でのみ一意であることが保証されます。
type常にaudio
filenameストリングファイルの元のファイル名。このファイル名の拡張子は、ファイルの拡張子と一致する必要があります。
file_pathサービス内の他のファイルに対するファイルの相対パス。たとえば、バックアップ内のパスなどです。
transcription文字列、オプションオーディオ メッセージのテキスト トランスクリプション (利用可能な場合)。

{
  "id": "abc123",
  "type": "audio",
  "filename": "Audio Message.caf",
  "file_path": "Library/SMS/Attachments/.../Audio Message.caf",
  "transcription": "Test voice message",
}

音声転写

バックアップのデータで利用可能な場合、音声メッセージの文字起こしがaudioオブジェクトの一部として返されます。これは、iOS 17 以降の iOS メッセージで作成されたオーディオ メッセージで利用できます。

メッセージ

属性

名前タイプ説明
idストリングメッセージの一意の識別子。必要に応じて、これを使用して返されたデータを重複排除します。
data_type文字列、常にmessageデータ型指定子。
type文字列、オプションメッセージング サービスがさまざまな種類のメッセージを処理するときに使用されます。たとえば、iOS メッセージの場合はSMSiMessageです。
handle会話の 2 番目のパーティ。多くの場合、メッセージング アプリに固有の識別子。
handle_name文字列、オプション可能な場合は、ハンドルの表示名。
contactネストされた連絡先、オプション会話の相手の iOS 連絡先を参照するオブジェクト。
conversation_idストリング会話ごとにメッセージをグループ化する識別子。
from_meブールメッセージが送信されたか受信されたか。
user文字列、オプション複数のユーザー/アカウントがデバイスからメッセージング アプリを使用している可能性がある場合のメッセージング アプリのユーザー。
textストリングメッセージの本文。
edits編集リスト、オプションメッセージ編集がサポートされ、履歴がバックアップに保存されているアプリのメッセージ コンテンツ編集のリスト。
attachmentsファイルのリスト、オプションdownload_fileメソッドで使用できるfile_id値の配列。メッセージに添付ファイルが含まれていない場合は、空の配列が返されます。
group文字列、オプションメッセージが送信された時点のグループの名前。
group_id文字列、オプションそのアプリのコンテキスト内でのグループの一意の識別子。これは整数ではない可能性があり、存在する場合は、 conversation_idに加えて情報のみを提供します。
group_handles文字列のリスト、オプション個人間のメッセージの場合、この値はnullであり、グループの会話では、電話番号または iMessage の電子メール アドレスを表す文字列の配列です。
group_contacts文字列、オプショングループ内の iOS 連絡先を参照するオブジェクトの配列。
deletedブール値、オプションメッセージが削除されたかどうかを示すブール値。
marked_unreadブール値、オプション可能な場合、ユーザーがメッセージを未読としてマークしたかどうか。
date日付時刻メッセージがいつ送信または受信されたか。
date_read日時、オプションメッセージが最初に読まれたとき (利用可能な場合)。
date_edited日時、オプションメッセージが最後に編集された日時 (該当する場合)。
date_deleted日時、オプション該当する場合、メッセージが削除されたとき。

{
  "id": "a1b2c3d4",
  "data_type": "message",
  "type": "SMS",
  "handle": "reincubate",
  "handle_name": "Reincubate",
  "conversation_id": "w6x7y8z9",
  "from_me": false,
  "text": "Hi from London!",
  "edits": [{
    "text": "Hi!",
    "date": "2023-06-27T10:20:00.000000Z"
  }, {
    "text": "Hi from London!",
    "date": "2023-06-27T10:21:00.000000Z"
  }],
  "attachments": [],
  "group_handles": [
    "+441234567890",
    "renate@reincubate.com"
  ],
  "deleted": false,
  "date": "2023-06-27T10:20:00.000000Z",
  "date_edited": "2023-06-27T10:21:00.000000Z"
}

メッセージ ハンドルと会話

API のデータ エクストラクタは、歴史的に幅広いソース データをサポートし、時間の経過とともにアプリや iOS の更新によって断片化されたデータを再編成しようとします。メッセージング アプリは新機能を追加する際、基礎となるデータが新しい構造に完全に移行されるよう常に注意を払っているわけではありません。したがって、一貫性のあるデータを返すために、API は特定の情報を推測する必要があります。

そのようなケースの 1 つは、メッセージング アプリ、特にios_messages.messagesデータ モジュールから返されるハンドルと会話情報です。 API は、数値識別子 (そのような情報が存在するか推測できる場合)、またはセカンド パーティのハンドルを使用してconversation_id conversation_id設定します。したがって、このフィールドを使用して、同じチャットからのメッセージを結合することをお勧めします。

編集および削除されたメッセージ

編集および削除されたメッセージに関する情報は、iOS 16 以降を実行しているデバイスから作成されたバックアップのios_messages.messagesで利用できます。削除されたメッセージの場合、情報が入手できるのは、バックアップが作成された時点でメッセージがまだ回復可能である間のみであると予想されます。Apple によれば、それは削除後 30 ~ 40 日後です

編集されたメッセージの場合、編集履歴はedits属性で返されます。各編集には、 textの状態と編集がコミットされた時刻が含まれます。メッセージ自体のtext属性は、最終編集のテキスト属性と常に同じになります。

会話

会話スレッド。

名前タイプ説明
idストリングアイテムID。
data_type文字列、常にconversation項目データ型 ID。
groupオプションの文字列グループの名前。
members contact一覧会話の参加者。

連絡先

contact属性

名前タイプ説明
idストリングアイテムID。
data_type文字列、常にcontact項目データ型 ID。
nameオプションの文字列連絡先の氏名。
first_nameオプションの文字列連絡先の名。
middle_nameオプションの文字列連絡先のミドル ネーム。
last_nameオプションの文字列連絡先の姓。
prefixオプションの文字列連絡先の名前のプレフィックス。
suffixオプションの文字列連絡先の名前のサフィックス。
nicknameオプションの文字列連絡先のニックネーム。
records contact.record項目のリスト連絡先に関連付けられた連絡先レコード。
organisationオプションの文字列連絡先の組織名。
departmentオプションの文字列組織内の連絡先の部門。
jobtitleオプションの文字列組織内での連絡先の役職。
birthday任意の日付連絡先の誕生日。

contact.record属性

連絡先レコードアイテムには、 PhoneEmailURLSocialAddress 5種類がありURL 。これらは、それぞれ電話番号、電子メールアドレス、WebサイトURL、ソーシャルメディアアカウントハンドル、および番地に対応しています。

最初の4つは同じ属性を持っています。

名前タイプ説明
typeストリングPhoneEmailURLSocialのいずれか。
nameオプションの文字列レコードに関連付けられたラベル。
valueストリングレコードの値。

Address連絡先レコードタイプには、追加の住所フィールドがあります。

名前タイプ説明
type文字列、常にAddress電話番号の記録。
nameオプションの文字列番号に関連付けられたラベル。
CountryCodeオプションの文字列国コード。
Countryオプションの文字列国名。
ZIPオプションの文字列郵便番号。
Stateオプションの文字列州の名前または略語。
Cityオプションの文字列都市名。
Municipalityオプションの文字列自治体名です。
SubLocalityオプションの文字列近隣または地域の名前。
Streetオプションの文字列番地名。

サンプルデータ

{
  "id": "2cf6a837304d6614",
  "data_type": "contact",
  "first_name": "John",
  "middle_name": "'Gala'",
  "last_name": "Appleseed",
  "prefix": "Mr.",
  "suffix": "Jr.",
  "nickname": "John'o",
  "records": [
    {
      "type": "Phone",
      "name": "MAIN",
      "value": "1-800-MY-APPLE"
    },
    {
      "type": "Phone",
      "name": "UK",
      "value": "0800 039 1010"
    },
    {
      "type": "URL",
      "name": "HOMEPAGE",
      "value": "http://www.apple.com"
    },
    {
      "type": "URL",
      "name": "HOMEPAGE",
      "value": "http://www.apple.com/uk/"
    },
    {
      "City": "Cupertino",
      "State": "CA",
      "ZIP": "95014",
      "name": "WORK",
      "CountryCode": "US",
      "Country": "United States",
      "Street": "1 Infinite Loop",
      "type": "Address",
      "SubLocality": null,
      "Municipality": null
    }
  ],
  "organisation": "Apple Inc.",
  "department": "Marketing",
  "jobtitle": "VP Juicing",
  "birthday": "1976-04-01"
}

コール

属性

名前タイプ説明
idストリングアイテムID。
data_type文字列、常にcall項目データ型 ID。
call_typeストリングPhoneFaceTime VideoFaceTime Audioのいずれか。
addressストリング呼び出しのターゲット。電話番号、Apple ID、またはその他の識別子の可能性があります。
duration浮く通話時間。
answeredブール通話に応答したかどうか。
from_meブール通話が発信か着信か。
date日付時刻コールが行われたとき。

サンプルデータ

{
  "id": "24116c5b16b85217",
  "data_type": "call",
  "call_type": "Phone",
  "address": "07123456789",
  "duration": 5.131359,
  "answered": false,
  "from_me": true,
  "date": "2015-07-20 10:23:27.538011"
}

イベント

event属性

名前タイプ説明
idストリングアイテムID。
data_type文字列、常にevent項目データ型 ID。
unique_identifierオプションの文字列複数のイベント データ ソース間で重複排除するためのアイテム UID。
calendarオプションの文字列カレンダー名。
calendar_uidオプションの文字列カレンダー UID。
calendar_storeオプションの文字列カレンダー ストア タイプ、つまりiCloudDefault
summaryオプションの文字列イベントの概要またはタイトル。
descriptionオプションの文字列イベントの説明。
start_dateオプションの日時イベント開始時。
end_dateオプションの日時イベント終了時。
start_time_zoneオプションの文字列start_dateのタイムゾーン。
end_time_zoneオプションの文字列end_dateのタイムワン。
all_dayブール値イベントが終日続くかどうか。
travel_timeオプションの期間イベントの移動時間。
recurrenceオプションのネストされたevent.recurrenceイベントの繰り返し設定。
locationオプションの文字列イベントが行われている場所。
start_locationオプションの文字列イベントが開始される場所。
attendeesオプションの文字列リストイベント参加者の名前。
attached_urlオプションの文字列イベントに関連付けられた URL。
creation_dateオプションの日時イベントが作成されたとき。祝日など、既定のカレンダー エントリの場合は設定されません。

event.recurrence属性

名前タイプ説明
interval整数repeatの回数、つまり 1 Yearly (1 年に 1 回)。
repeatストリングOneTimeDailyWeeklyMonthlyYearlyのいずれか。
repeat_end_dateオプションの日時いつ再発を停止するか。

サンプルデータ

{
  "id": "3",
  "unique_identifier": "f5fcf872-34f6-3f60-ba03-74d5a7a3bbbb",
  "calendar": "Home",
  "calendar_id": "477a2001537fe178d6b77cdceb8bac2e",
  "calendar_store": "Default",
  "summary": "Christmas Day",
  "description": "Bank holiday in the UK",
  "start_date": "2017-12-25T00:00:00.000000",
  "end_date": "2017-12-25T23:59:59.000000",
  "start_time_zone": None,
  "end_time_zone": None,
  "all_day": True,
  "travel_time": None,
  "recurrence": {
    "interval": 1,
    "repeat": "Yearly",
    "repeat_end_date": None,
    "specifier": ""
  },
  "location": None,
  "start_location": None,
  "attendees": ["John Appleseed"],
  "attached_url": None,
  "creation_date": None
}

注意

{
  "title": "Monday meeting:",
  "note": "Monday meeting:\n Discuss X,\n discuss Y.",
  "summary": null,
  "folder": "icloud",
  "sub_folder": "work",
  "attachments": [
    {
      "type": "image",
      "file_id": "8e22cf6e524357b4eb3da775d193072ebba9543f",
      "file_path": "Media/80DDDEAD-B33F-37B2-7219432C0359/Image.jpeg"
    }
  ],
  "creation_date": "2016-06-06 13:23:20.000000",
  "last_modified": "2016-06-07 15:21:25.000000"
}

訪問

ウェブサイトのページ訪問の記録。

属性

名前タイプ説明
data_type文字列、常にvisit項目データ型 ID。
urlストリングアクセスしたページの URL。
titleストリング訪問したページのタイトル。
date_created日付時刻訪問が発生したとき。
{
  "data_type": "visit",
  "url": "https://reincubate.com/",
  "title": "Reincubate: the app data company",
  "date_created": "2020-01-01T00:00:00.000000Z"
}

クッキー

HTTP Cookie。

属性

名前タイプ説明
data_type文字列、常にcookie項目データ型 ID。
nameストリングクッキーの名前。
valueストリングCookie の値。
domainストリングCookie のドメイン指定子。
pathストリングCookie のパス指定子。
flagsストリングCookie に設定されたフラグ。
creation_date日付時刻クッキーが作成されたとき。
expiry_date日付時刻クッキーの有効期限が切れたとき。
{
  "data_type": "cookie",
  "name": "sample_cookies",
  "value": "sample_value",
  "domain": "reincubate.com",
  "path": "/",
  "flags": "",
  "creation_date": "2020-01-01T00:00:00.000000Z",
  "expiry_date": "2020-01-01T00:00:00.000000Z"
}

ロケーション

データ属性

名前タイプ説明
data_type文字列、常にlocationデータ型識別子。
latitude浮く場所の緯度座標。
longitude浮く場所の経度座標。
altitude浮く場所の高度座標。
horizontal_accuracy浮く測定の水平精度。
vertical_accuracy浮く測定の垂直精度。
position_typeストリング使用された測定方法の識別子。
date_created日付時刻測定が行われたとき。

サンプルデータ

{
  "data_type": "location",
  "latitude": 51.507452392689146,
  "longitude": -0.07398372304584414,
  "altitude": 0.0,
  "horizontal_accuracy": 65.0,
  "vertical_accuracy": 0.0,
  "positioning_type": "Wifi",
  "date_created": "2020-01-01T00:00:00.000000Z"
}

どのように我々は助けることができます?

サポートチームがお手伝いします!

営業時間は月曜日から金曜日の午前9時から午後5時(GMT)です。 時間は現在 5:52 PM GMTです。

1営業日以内に、お返事を差し上げます。メールアドレスはこちら。

私たちの素晴らしいサポートチーム

© 2008 - 2024 Reincubate Ltd. 無断複写・転載を禁じます。 イングランドとウェールズに登録 #5189175, VAT GB151788978. Reincubate®およびCamo®は登録商標です。 個人情報保護方針 & 条項.