Method: requestStatus.retrieve

• HTTP リクエスト
• クエリ パラメータ
• リクエストの本文
• レスポンスの本文
  • JSON 表現
• 認可スコープ
• RequestStatusPerDestination
  • JSON 表現
• RequestStatus
• ErrorInfo
  • JSON 表現
• ErrorCount
  • JSON 表現
• ProcessingErrorReason
• WarningInfo
  • JSON 表現
• WarningCount
  • JSON 表現
• ProcessingWarningReason
• IngestAudienceMembersStatus
  • JSON 表現
• IngestUserDataStatus
  • JSON 表現
• MatchRateRange
• IngestMobileDataStatus
  • JSON 表現
• IngestPairDataStatus
  • JSON 表現
• IngestEventsStatus
  • JSON 表現
• RemoveAudienceMembersStatus
  • JSON 表現
• RemoveUserDataStatus
  • JSON 表現
• RemoveMobileDataStatus
  • JSON 表現
• RemovePairDataStatus
  • JSON 表現
• 試してみる

リクエスト ID を指定してリクエストのステータスを取得します。

HTTP リクエスト

GET https://datamanager.googleapis.com/v1/requestStatus:retrieve

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
requestId	string 必須。必須。データマネージャー API リクエストのリクエスト ID。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

RetrieveRequestStatusRequest からのレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{ "requestStatusPerDestination": [ { object (RequestStatusPerDestination) } ] }

フィールド
requestStatusPerDestination[]	object (RequestStatusPerDestination) 宛先ごとのリクエスト ステータスのリスト。ステータスの順序は、元のリクエストの宛先の順序と一致します。

認可スコープ

次の OAuth スコープが必要です。

• https://www.googleapis.com/auth/datamanager

RequestStatusPerDestination

宛先ごとのリクエスト ステータス。

JSON 表現

{ "destination": { object (Destination) }, "requestStatus": enum (RequestStatus), "errorInfo": { object (ErrorInfo) }, "warningInfo": { object (WarningInfo) }, // Union field status can be only one of the following: "audienceMembersIngestionStatus": { object (IngestAudienceMembersStatus) }, "eventsIngestionStatus": { object (IngestEventsStatus) }, "audienceMembersRemovalStatus": { object (RemoveAudienceMembersStatus) } // End of list of possible types for union field status. }

フィールド
destination	object (Destination) DM API リクエスト内の宛先。
requestStatus	enum (RequestStatus) 宛先のリクエスト ステータス。
errorInfo	object (ErrorInfo) アップロードに関連するエラーの理由とエラー数を含むエラー情報エラー。
warningInfo	object (WarningInfo) アップロードに関連する警告理由と警告数を含む警告情報。
共用体フィールド status。宛先のステータス。status は次のいずれかになります。
audienceMembersIngestionStatus	object (IngestAudienceMembersStatus) オーディエンス メンバーの取り込みリクエストのステータス。
eventsIngestionStatus	object (IngestEventsStatus) 取り込みイベント リクエストのステータス。
audienceMembersRemovalStatus	object (RemoveAudienceMembersStatus) オーディエンス メンバーの削除リクエストのステータス。

RequestStatus

リクエストのステータス。

列挙型
REQUEST_STATUS_UNKNOWN	リクエストのステータスは不明です。
SUCCESS	リクエストが成功しました。
PROCESSING	リクエストを処理中です。
FAILED	リクエストが失敗しました。
PARTIAL_SUCCESS	リクエストが部分的に成功しました。

ErrorInfo

各タイプのエラーのエラー数。

JSON 表現
{ "errorCounts": [ { object (ErrorCount) } ] }

フィールド
errorCounts[]	object (ErrorCount) エラーのリストとエラーの理由ごとのカウント。場合によっては入力されないことがあります。

ErrorCount

特定のエラー理由のエラー数。

JSON 表現
{ "recordCount": string, "reason": enum (ProcessingErrorReason) }

フィールド
recordCount	string (int64 format) 特定の理由でアップロードできなかったレコードの数。
reason	enum (ProcessingErrorReason) 失敗したレコードのエラー理由。

ProcessingErrorReason

処理エラーの理由。

列挙型
PROCESSING_ERROR_REASON_UNSPECIFIED	処理エラーの理由は不明です。
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE	カスタム変数が無効です。
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED	カスタム変数のステータスが有効になっていません。
PROCESSING_ERROR_REASON_EVENT_TOO_OLD	コンバージョンの年齢が、サポートされている年齢の上限を超えています。
PROCESSING_ERROR_REASON_DENIED_CONSENT	広告ユーザーデータがユーザーまたは広告主様のデフォルト設定によって拒否されている。
PROCESSING_ERROR_REASON_NO_CONSENT	広告主が広告のコア プラットフォーム サービスについてサードパーティに同意を与えていない。
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	このユーザーの全体的な同意（行レベルの同意、リクエスト レベルの同意、アカウント設定から判断）を特定できませんでした
PROCESSING_ERROR_REASON_DUPLICATE_GCLID	GCLID とコンバージョン日時が同じコンバージョンがすでにシステムに存在します。
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID	同じオーダー ID とコンバージョン アクションの組み合わせのコンバージョンがすでにアップロードされています。
PROCESSING_ERROR_REASON_INVALID_GBRAID	gbraid をデコードできませんでした。
PROCESSING_ERROR_REASON_INVALID_GCLID	Google クリック ID をデコードできませんでした。
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID	販売者 ID に数字以外の文字が含まれています。
PROCESSING_ERROR_REASON_INVALID_WBRAID	wbraid をデコードできませんでした。
PROCESSING_ERROR_REASON_INTERNAL_ERROR	内部エラーです。
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED	移行先のアカウントで拡張コンバージョンの利用規約に同意していません。
PROCESSING_ERROR_REASON_INVALID_EVENT	イベントが無効です。
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS	一致した取引が最小しきい値を下回っています。
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS	トランザクションが最小しきい値を下回っています。
PROCESSING_ERROR_REASON_INVALID_FORMAT	イベントの形式にエラーがあります。
PROCESSING_ERROR_REASON_DECRYPTION_ERROR	イベントに復号エラーがあります。
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR	DEK を復号できませんでした。
PROCESSING_ERROR_REASON_INVALID_WIP	WIP の形式が正しくないか、WIP が存在しません。
PROCESSING_ERROR_REASON_INVALID_KEK	KEK が間違っているか、存在しないため、KEK でデータを復号できません。
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED	WIP は証明書条件によって拒否されたため、使用できませんでした。
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED	システムに KEK へのアクセスに必要な権限がありませんでした。
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	DEK を使用して UserIdentifier データを復号できませんでした。
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER	ユーザーが、運用アカウントの広告のものではない広告識別子を使用してイベントを取り込もうとしました。

WarningInfo

警告タイプごとの警告数。

JSON 表現
{ "warningCounts": [ { object (WarningCount) } ] }

フィールド
warningCounts[]	object (WarningCount) 警告のリストと、警告理由ごとのカウント。

WarningCount

特定の警告理由の警告数。

JSON 表現
{ "recordCount": string, "reason": enum (ProcessingWarningReason) }

フィールド
recordCount	string (int64 format) 警告のあるレコードの数。
reason	enum (ProcessingWarningReason) 警告の理由。

ProcessingWarningReason

処理上の警告の理由。

列挙型
PROCESSING_WARNING_REASON_UNSPECIFIED	処理上の警告の理由は不明です。
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED	システムに KEK へのアクセスに必要な権限がありませんでした。
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR	DEK を復号できませんでした。
PROCESSING_WARNING_REASON_DECRYPTION_ERROR	イベントに復号エラーがあります。
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED	WIP は証明書条件によって拒否されたため、使用できませんでした。
PROCESSING_WARNING_REASON_INVALID_WIP	WIP の形式が正しくないか、WIP が存在しません。
PROCESSING_WARNING_REASON_INVALID_KEK	KEK が間違っているか、存在しないため、KEK でデータを復号できません。
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	DEK を使用して UserIdentifier データを復号できませんでした。
PROCESSING_WARNING_REASON_INTERNAL_ERROR	内部エラーです。

IngestAudienceMembersStatus

オーディエンス メンバーの取り込みリクエストのステータス。

JSON 表現
{ // Union field status can be only one of the following: "userDataIngestionStatus": { object (IngestUserDataStatus) }, "mobileDataIngestionStatus": { object (IngestMobileDataStatus) }, "pairDataIngestionStatus": { object (IngestPairDataStatus) } // End of list of possible types for union field status. }

フィールド
共用体フィールド status。宛先へのオーディエンス メンバーの取り込みステータス。status は次のいずれかになります。
userDataIngestionStatus	object (IngestUserDataStatus) 宛先へのユーザーデータの取り込みステータス。
mobileDataIngestionStatus	object (IngestMobileDataStatus) 宛先へのモバイルデータの取り込みステータス。
pairDataIngestionStatus	object (IngestPairDataStatus) 宛先へのペアデータの取り込みのステータス。

IngestUserDataStatus

取り込みに関連する統計情報を含む、宛先へのユーザーデータの取り込みのステータス。

JSON 表現
{ "recordCount": string, "userIdentifierCount": string, "uploadMatchRateRange": enum (MatchRateRange) }

フィールド
recordCount	string (int64 format) アップロード リクエストで送信された、デスティネーションのオーディエンス メンバーの合計数。リクエスト内のすべてのオーディエンス メンバーが含まれます。取り込みが成功したかどうかは関係ありません。
userIdentifierCount	string (int64 format) アップロード リクエストで送信されたユーザー識別子の合計数。リクエスト内のすべてのユーザー識別子が含まれます。取り込みが成功したかどうかは関係ありません。
uploadMatchRateRange	enum (MatchRateRange) アップロードのマッチ率の範囲。

MatchRateRange

アップロードまたはユーザーリストのマッチ率の範囲。

列挙型
MATCH_RATE_RANGE_UNKNOWN	マッチ率の範囲が不明です。
MATCH_RATE_RANGE_NOT_ELIGIBLE	一致率の範囲が対象外です。
MATCH_RATE_RANGE_LESS_THAN_20	マッチ率の範囲が 20% 未満（[0, 20) の間隔）です。
MATCH_RATE_RANGE_20_TO_30	マッチ率の範囲は 20% ～ 30%（[20, 31) の間隔）です。
MATCH_RATE_RANGE_31_TO_40	マッチ率の範囲は 31% ～ 40%（間隔 [31, 41)）です。
MATCH_RATE_RANGE_41_TO_50	マッチ率の範囲は 41% ～ 50%（[41, 51) の間隔）です。
MATCH_RATE_RANGE_51_TO_60	マッチ率の範囲は 51% ～ 60%（間隔 [51, 61)）です。
MATCH_RATE_RANGE_61_TO_70	マッチ率の範囲は 61% ～ 70%（[61, 71) の間隔）です。
MATCH_RATE_RANGE_71_TO_80	マッチ率の範囲は 71% ～ 80%（間隔 [71, 81)）です。
MATCH_RATE_RANGE_81_TO_90	マッチ率の範囲は 81 ～ 90%（[81, 91) の間隔）です。
MATCH_RATE_RANGE_91_TO_100	一致率の範囲は 91% ～ 100%（[91, 100] の間隔）です。

IngestMobileDataStatus

モバイルデータの取り込みのステータス。取り込みに関連する統計情報が含まれます。

JSON 表現
{ "recordCount": string, "mobileIdCount": string }

フィールド
recordCount	string (int64 format) アップロード リクエストで送信された、デスティネーションのオーディエンス メンバーの合計数。リクエスト内のすべてのオーディエンス メンバーが含まれます。取り込みが成功したかどうかは関係ありません。
mobileIdCount	string (int64 format) アップロード リクエストで送信されたモバイル ID の合計数。リクエスト内のすべてのモバイル ID が含まれます。取り込みに成功したかどうかは関係ありません。

IngestPairDataStatus

ペアデータの取り込みのステータス。取り込みに関連する統計情報が含まれます。

JSON 表現
{ "recordCount": string, "pairIdCount": string }

フィールド
recordCount	string (int64 format) アップロード リクエストで送信された、デスティネーションのオーディエンス メンバーの合計数。リクエスト内のすべてのオーディエンス メンバーが含まれます。取り込みが成功したかどうかは関係ありません。
pairIdCount	string (int64 format) アップロード リクエストで送信されたペア ID の合計数。リクエスト内のすべてのペア ID が含まれます。取り込みが成功したかどうかは関係ありません。

IngestEventsStatus

宛先へのイベント取り込みのステータス。

JSON 表現
{ "recordCount": string }

フィールド
recordCount	string (int64 format) アップロード リクエストで送信されたイベントの合計数。リクエスト内のすべてのイベントが含まれます。イベントが正常に取り込まれたかどうかは関係ありません。

RemoveAudienceMembersStatus

オーディエンス メンバーの削除リクエストのステータス。

JSON 表現
{ // Union field status can be only one of the following: "userDataRemovalStatus": { object (RemoveUserDataStatus) }, "mobileDataRemovalStatus": { object (RemoveMobileDataStatus) }, "pairDataRemovalStatus": { object (RemovePairDataStatus) } // End of list of possible types for union field status. }

フィールド
共用体フィールド status。宛先からのオーディエンス メンバーの削除ステータス。status は次のいずれかになります。
userDataRemovalStatus	object (RemoveUserDataStatus) 宛先からのユーザーデータの削除ステータス。
mobileDataRemovalStatus	object (RemoveMobileDataStatus) 移行先からのモバイルデータの削除ステータス。
pairDataRemovalStatus	object (RemovePairDataStatus) 宛先からのペアデータの削除ステータス。

RemoveUserDataStatus

宛先からのユーザーデータの削除ステータス。

JSON 表現
{ "recordCount": string, "userIdentifierCount": string }

フィールド
recordCount	string (int64 format) 削除リクエストで送信されたオーディエンス メンバーの合計数。リクエストには、削除に成功したかどうかに関係なく、すべてのユーザーリストのメンバーが含まれます。
userIdentifierCount	string (int64 format) 削除リクエストで送信されたユーザー ID の合計数。リクエスト内のすべてのユーザー識別子が含まれます（削除が成功したかどうかは問いません）。

RemoveMobileDataStatus

移行先からのモバイルデータの削除ステータス。

JSON 表現
{ "recordCount": string, "mobileIdCount": string }

フィールド
recordCount	string (int64 format) 削除リクエストで送信されたオーディエンス メンバーの合計数。リクエストには、削除に成功したかどうかに関係なく、すべてのユーザーリストのメンバーが含まれます。
mobileIdCount	string (int64 format) 削除リクエストで送信されたモバイル ID の合計数。リクエスト内のすべてのモバイル ID が含まれます。削除が成功したかどうかは関係ありません。

RemovePairDataStatus

宛先からのペアデータの削除ステータス。

JSON 表現
{ "recordCount": string, "pairIdCount": string }

フィールド
recordCount	string (int64 format) 削除リクエストで送信されたオーディエンス メンバーの合計数。リクエストには、削除に成功したかどうかに関係なく、すべてのユーザーリストのメンバーが含まれます。
pairIdCount	string (int64 format) 削除リクエストで送信されたペア ID の合計数。リクエスト内のすべてのペア ID が含まれます。削除に成功したかどうかは関係ありません。