此页面由 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`	请求部分成功。

错误信息

每种类型的错误数量。

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 广告核心平台服务提供第三方同意声明。
`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)` 警告列表以及每个警告原因的计数。

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 的格式不正确或 WIP 不存在。
`PROCESSING_WARNING_REASON_INVALID_KEK`	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)` 上传请求中针对相应目标平台发送的用户标识符总数。包含请求中的所有用户标识符，无论是否成功提取。
`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，无论是否成功提取。

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)` 移除请求中发送的用户标识符总数。包含请求中的所有用户标识符，无论是否已成功移除。

recordCount

string (int64 format)

移除请求中发送的受众群体成员总数。包括请求中的所有受众群体成员，无论是否已成功移除。

userIdentifierCount

string (int64 format)

移除请求中发送的用户标识符总数。包含请求中的所有用户标识符，无论是否已成功移除。

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

错误信息

ErrorCount

ProcessingErrorReason

WarningInfo

WarningCount

ProcessingWarningReason

IngestAudienceMembersStatus

IngestUserDataStatus

MatchRateRange

IngestMobileDataStatus

IngestPairDataStatus

IngestEventsStatus

RemoveAudienceMembersStatus

RemoveUserDataStatus

RemoveMobileDataStatus

RemovePairDataStatus

Method: requestStatus.retrieve