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 表示法
• IngestUserIdDataStatus
  • JSON 表示法
• IngestPpidDataStatus
  • JSON 表示法
• IngestCompositeDataStatus
  • JSON 表示法
• DataTypeCount
  • JSON 表示法
• DataType
• IngestEventsStatus
  • JSON 表示法
• RemoveAudienceMembersStatus
  • JSON 表示法
• RemoveUserDataStatus
  • JSON 表示法
• RemoveMobileDataStatus
  • JSON 表示法
• RemovePairDataStatus
  • JSON 表示法
• RemoveUserIdDataStatus
  • JSON 表示法
• RemovePpidDataStatus
  • JSON 表示法
• RemoveCompositeDataStatus
  • JSON 表示法
• 試試看！

根據要求 ID 取得要求狀態。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
requestId	string 必填。必填。Data Manager 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) 包含與上傳相關的錯誤原因和錯誤計數的錯誤資訊錯誤。只有在 requestStatus 為 FAILED 或 PARTIAL_SUCCESS 時，才會填入這個欄位。如果要求具有 requestStatus 的 PROCESSING，系統就不會填入這個欄位。
warningInfo	object (WarningInfo) 警告資訊，內含與上傳作業相關的警告原因和警告次數。如果要求具有 requestStatus 的 PROCESSING，系統就不會填入這個欄位。
聯集欄位 status。目的地的狀態。status 只能是下列其中一項：
audienceMembersIngestionStatus	object (IngestAudienceMembersStatus) 匯入目標對象成員要求的狀態。
eventsIngestionStatus	object (IngestEventsStatus) 擷取事件要求的狀態。
audienceMembersRemovalStatus	object (RemoveAudienceMembersStatus) 移除目標對象成員要求的狀態。

RequestStatus

要求狀態。

列舉
REQUEST_STATUS_UNKNOWN	要求狀態不明。
SUCCESS	所有記錄都已成功處理，未發生任何錯誤。不過，warningInfo 欄位中可能會出現警告。
PROCESSING	要求正在處理中。
FAILED	所有記錄的處理作業皆失敗。查看 errorInfo 欄位瞭解錯誤詳細資料，並查看 warningInfo 欄位瞭解警告詳細資料。
PARTIAL_SUCCESS	部分記錄順利完成處理，但其他記錄發生錯誤。查看 errorInfo 欄位瞭解錯誤詳細資料，並查看 warningInfo 欄位瞭解警告詳細資料。

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	廣告主未同意第三方使用 Google Ads 核心平台服務。
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	無法判斷這位使用者的整體同意聲明 (根據資料列層級同意聲明、要求層級同意聲明和帳戶設定判斷)
PROCESSING_ERROR_REASON_DUPLICATE_GCLID	系統中已有含有相同 Google 點擊 ID 和轉換時間的轉換資料。
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 格式有誤或不存在。
PROCESSING_ERROR_REASON_INVALID_KEK	KEK 不正確或不存在，因此無法解密資料。
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED	由於 WIP 遭認證條件拒絕，因此無法使用。
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED	系統沒有存取 KEK 的必要權限。
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED	系統無法通過 AWS 驗證。
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	無法使用 DEK 解密 UserIdentifier 資料。
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER	使用者嘗試擷取事件，但廣告 ID 並非來自作業帳戶的廣告。
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID	單次點擊單次轉換動作無法與 BRAID 搭配使用。
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND	找不到相符的 ID。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID	找不到相符 ID 的使用者 ID。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID	找不到 Google 點擊 ID 的使用者 ID。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID	找不到 DCLID 的使用者 ID。
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS	廣告 ID 無效。
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT	行動 ID 格式無效。
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND	找不到原始轉換。
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR	無法解碼事件 ID (dclid 或曝光 ID)。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID	系統找不到指定曝光 ID 的使用者 ID。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND	找不到使用者 ID。
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK	事件的時間戳記早於相關聯的點擊。
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK	點擊時間太近。
PROCESSING_ERROR_REASON_INVALID_CLICK	事件無法歸因於特定點擊 (Google 點擊 ID)。舉例來說，原因可能是該點擊並非來自 Google Ads 廣告活動。
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK	事件中的點擊與目的地的 operatingAccount 無關。
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND	找不到與所提供屬性相符的點擊。

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 格式有誤或不存在。
PROCESSING_WARNING_REASON_INVALID_KEK	KEK 不正確或不存在，因此無法解密資料。
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	無法使用 DEK 解密 UserIdentifier 資料。
PROCESSING_WARNING_REASON_INTERNAL_ERROR	發生內部錯誤。
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED	系統無法通過 AWS 驗證。

IngestAudienceMembersStatus

匯入目標對象成員要求的狀態。

JSON 表示法

{ // Union field status can be only one of the following: "userDataIngestionStatus": { object (IngestUserDataStatus) }, "mobileDataIngestionStatus": { object (IngestMobileDataStatus) }, "pairDataIngestionStatus": { object (IngestPairDataStatus) }, "userIdDataIngestionStatus": { object (IngestUserIdDataStatus) }, "ppidDataIngestionStatus": { object (IngestPpidDataStatus) }, "compositeDataIngestionStatus": { object (IngestCompositeDataStatus) } // End of list of possible types for union field status. }

欄位
聯集欄位 status。目標對象成員擷取至目的地的狀態。status 只能是下列其中一項：
userDataIngestionStatus	object (IngestUserDataStatus) 使用者資料擷取至目的地的狀態。
mobileDataIngestionStatus	object (IngestMobileDataStatus) 行動資料擷取至目的地的狀態。
pairDataIngestionStatus	object (IngestPairDataStatus) 將成對資料擷取至目的地的狀態。
userIdDataIngestionStatus	object (IngestUserIdDataStatus) 使用者 ID 資料擷取至目的地的狀態。
ppidDataIngestionStatus	object (IngestPpidDataStatus) 將 PPID 資料擷取至目的地的狀態。
compositeDataIngestionStatus	object (IngestCompositeDataStatus) 複合資料擷取至目的地的狀態。

IngestUserDataStatus

使用者資料擷取至目的地的狀態，其中包含與擷取作業相關的統計資料。

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

欄位
recordCount	string (int64 format) 上傳要求中傳送至目的地的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功擷取都一樣。
userIdentifierCount	string (int64 format) 上傳要求中傳送至目的地的使用者 ID 總數。包括要求中的所有使用者 ID，無論是否成功擷取。
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，無論是否成功擷取。

IngestUserIdDataStatus

使用者 ID 資料擷取至目的地的狀態，其中包含與擷取作業相關的統計資料。

JSON 表示法
{ "recordCount": string, "userIdCount": string }

欄位
recordCount	string (int64 format) 上傳要求中傳送至目的地的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功擷取都一樣。
userIdCount	string (int64 format) 上傳要求中傳送至目的地的使用者 ID 總數。包括要求中的所有使用者 ID，無論是否成功擷取。

IngestPpidDataStatus

將 ppid 資料擷取至目的地的狀態，其中包含與擷取作業相關的統計資料。

JSON 表示法
{ "recordCount": string, "ppidCount": string }

欄位
recordCount	string (int64 format) 上傳要求中傳送至目的地的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功擷取都一樣。
ppidCount	string (int64 format) 上傳要求中傳送至目的地的 PPID 總數。包括要求中的所有 ppid，無論是否成功擷取。

IngestCompositeDataStatus

複合資料擷取至目的地的狀態，其中包含與擷取作業相關的統計資料。

JSON 表示法
{ "recordCount": string, "dataTypeCounts": [ { object (DataTypeCount) } ], "uploadMatchRateRange": enum (MatchRateRange) }

欄位
recordCount	string (int64 format) 上傳要求中傳送至目的地的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功擷取都一樣。
dataTypeCounts[]	object (DataTypeCount) 上傳要求傳送至目的地的資料類型總數，並依資料類型細分。包括要求中的所有資料類型，無論是否成功擷取。
uploadMatchRateRange	enum (MatchRateRange) 上傳內容的媒合率範圍。

DataTypeCount

特定資料類型的數量。

JSON 表示法
{ "type": enum (DataType), "count": string }

欄位
type	enum (DataType) 資料類型。
count	string (int64 format) 這類資料的數量。

DataType

資料類型。

列舉
DATA_TYPE_UNSPECIFIED	未指定資料類型。
EMAIL	資料為電子郵件地址。
PHONE_NUMBER	資料為電話號碼。
ADDRESS	這項資料是實際地址。
IP_ADDRESS	資料為 IP 位址。

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) }, "userIdDataRemovalStatus": { object (RemoveUserIdDataStatus) }, "ppidDataRemovalStatus": { object (RemovePpidDataStatus) }, "compositeDataRemovalStatus": { object (RemoveCompositeDataStatus) } // End of list of possible types for union field status. }

欄位
聯集欄位 status。從目的地移除目標對象成員的狀態。status 只能是下列其中一項：
userDataRemovalStatus	object (RemoveUserDataStatus) 從目的地移除使用者資料的狀態。
mobileDataRemovalStatus	object (RemoveMobileDataStatus) 從目的地移除行動資料的狀態。
pairDataRemovalStatus	object (RemovePairDataStatus) 從目的地移除配對資料的狀態。
userIdDataRemovalStatus	object (RemoveUserIdDataStatus) 從目的地移除使用者 ID 資料的狀態。
ppidDataRemovalStatus	object (RemovePpidDataStatus) 從目的地移除 PPID 資料的狀態。
compositeDataRemovalStatus	object (RemoveCompositeDataStatus) 從目的地移除複合資料的狀態。

RemoveUserDataStatus

從目的地移除使用者資料的狀態。

JSON 表示法
{ "recordCount": string, "userIdentifierCount": string }

欄位
recordCount	string (int64 format) 移除要求中傳送的目標對象成員總數。包括要求中的所有目標對象成員，無論是否已成功移除。
userIdentifierCount	string (int64 format) 移除要求中傳送的使用者 ID 總數。包括要求中的所有使用者 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，無論是否已成功移除。

RemoveUserIdDataStatus

從目的地移除使用者 ID 資料的狀態。

JSON 表示法
{ "recordCount": string, "userIdCount": string }

欄位
recordCount	string (int64 format) 移除要求中傳送的目標對象成員總數。包括要求中的所有目標對象成員，無論是否已成功移除。
userIdCount	string (int64 format) 移除要求中傳送的使用者 ID 總數。包括要求中的所有使用者 ID，無論是否已成功移除。

RemovePpidDataStatus

從目的地移除 PPID 資料的狀態。

JSON 表示法
{ "recordCount": string, "ppidCount": string }

欄位
recordCount	string (int64 format) 移除要求中傳送的目標對象成員總數。包括要求中的所有目標對象成員，無論是否已成功移除。
ppidCount	string (int64 format) 移除要求中傳送的 ppid 總數。包括要求中的所有 ppid，無論是否已成功移除。

RemoveCompositeDataStatus

從目的地移除複合資料的狀態。

JSON 表示法
{ "recordCount": string, "dataTypeCounts": [ { object (DataTypeCount) } ] }

欄位
recordCount	string (int64 format) 移除要求中傳送的目標對象成員總數。包括要求中的所有目標對象成員，無論是否已成功移除。
dataTypeCounts[]	object (DataTypeCount) 移除要求中傳送的資料類型總數，並按資料類型細分。包括要求中的所有資料類型，無論是否已成功移除。