Method: requestStatus.retrieve

获取指定请求 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 字段可了解警告详情。

错误信息

每种类型的错误数量。

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_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_AWS_AUTH_FAILED 系统未能通过 AWS 身份验证。
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR 未能使用 DEK 解密 UserIdentifier 数据。
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER 用户尝试提取的事件包含的广告标识符并非来自操作账号的广告。
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 找不到相应 GCLID 的用户 ID。
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID 找不到与 DCLID 对应的用户 ID。
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS 存在无效的广告标识符。
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 相应事件无法归因于某个点击 (GCLID)。导致这种情况的原因可能是：这次点击不是由 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 的格式不正确或 WIP 不存在。
PROCESSING_WARNING_REASON_INVALID_KEK 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)

上传请求中针对相应目标平台发送的用户标识符总数。包含请求中的所有用户标识符，无论是否成功提取。
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 总数。包括请求中的所有 ppids，无论是否成功注入。

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)

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

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)

移除请求中发送的数据类型的总数，按数据类型细分。包括请求中的所有数据类型，无论是否已成功移除。