本頁面由 Cloud Translation API 翻譯而成。

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

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

查詢參數

參數

參數
`requestId`	`string` 必要欄位。必要欄位。Data Manager API 要求的 ID。

requestId

string

必要欄位。必要欄位。Data Manager API 要求的 ID。

要求主體

要求主體必須為空白。

回應主體

RetrieveRequestStatusRequest 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法
{ "requestStatusPerDestination": [ { object (`RequestStatusPerDestination`) } ] }

欄位

欄位
`requestStatusPerDestination[]`	`object (RequestStatusPerDestination)` 每個目的地的要求狀態清單。狀態的順序與原始要求中的目的地順序一致。

requestStatusPerDestination[]

object (RequestStatusPerDestination)

每個目的地的要求狀態清單。狀態的順序與原始要求中的目的地順序一致。

授權範圍

需要下列 OAuth 範圍：

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

RequestStatusPerDestination

每個目的地的要求狀態。

JSON 表示法

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)
  },
  "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)` 錯誤清單，以及各錯誤原因的計數。在某些情況下，系統可能不會填入這項資訊。

errorCounts[]

object (ErrorCount)

錯誤清單，以及各錯誤原因的計數。在某些情況下，系統可能不會填入這項資訊。

ErrorCount

特定錯誤原因的錯誤計數。

JSON 表示法
{ "recordCount": string, "reason": enum (`ProcessingErrorReason`) }

欄位

欄位
`recordCount`	`string (int64 format)` 因特定原因而無法上傳的記錄數。
`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_USER_IDENTIFIER_DECRYPTION_ERROR`	無法使用 DEK 解密 `UserIdentifier` 資料。
`PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER`	使用者嘗試擷取事件，但廣告 ID 並非來自作業帳戶的廣告。

WarningInfo

各類型警告的警告次數。

JSON 表示法
{ "warningCounts": [ { object (`WarningCount`) } ] }

欄位

欄位
`warningCounts[]`	`object (WarningCount)` 警告清單，以及每個警告原因的計數。

warningCounts[]

object (WarningCount)

警告清單，以及每個警告原因的計數。

WarningCount

特定警告原因的警告次數。

JSON 表示法
{ "recordCount": string, "reason": enum (`ProcessingWarningReason`) }

欄位

欄位
`recordCount`	`string (int64 format)` 含有警告的記錄數量。
`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`	發生內部錯誤。

IngestAudienceMembersStatus

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

JSON 表示法

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`. }

{

  // 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)` 上傳要求中傳送至目的地的使用者 ID 總數。包括要求中的所有使用者 ID，無論是否成功擷取。
`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，無論是否成功擷取。

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，無論是否成功擷取。

recordCount

string (int64 format)

上傳要求中傳送至目的地的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功擷取。

pairIdCount

string (int64 format)

上傳要求中傳送至目的地的配對 ID 總數。包括要求中的所有配對 ID，無論是否成功擷取。

IngestEventsStatus

事件擷取至目的地的狀態。

JSON 表示法
{ "recordCount": string }

欄位

欄位
`recordCount`	`string (int64 format)` 上傳要求中傳送的事件總數。包括要求中的所有事件，無論是否成功擷取。

recordCount

string (int64 format)

上傳要求中傳送的事件總數。包括要求中的所有事件，無論是否成功擷取。

RemoveAudienceMembersStatus

移除目標對象成員要求的狀態。

JSON 表示法

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`. }

{

  // 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 總數。包括要求中的所有使用者 ID，無論是否已成功移除。

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，無論是否已成功移除。

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，無論是否已成功移除。

recordCount

string (int64 format)

移除要求中傳送的目標對象成員總數。包括要求中的所有目標對象成員，無論是否成功移除。

pairIdCount

string (int64 format)

移除要求中傳送的配對 ID 總數。包括要求中的所有配對 ID，無論是否已成功移除。

Method: requestStatus.retrieve 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

HTTP 要求

查詢參數

要求主體

回應主體

授權範圍

RequestStatusPerDestination

RequestStatus

ErrorInfo

ErrorCount

ProcessingErrorReason

WarningInfo

WarningCount

ProcessingWarningReason

IngestAudienceMembersStatus

IngestUserDataStatus

MatchRateRange

IngestMobileDataStatus

IngestPairDataStatus

IngestEventsStatus

RemoveAudienceMembersStatus

RemoveUserDataStatus

RemoveMobileDataStatus

RemovePairDataStatus

Method: requestStatus.retrieve