Method: requestStatus.retrieve

요청 ID가 지정된 요청의 상태를 가져옵니다.

HTTP 요청

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

URL은 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)

업로드와 관련된 오류 이유와 오류 수를 포함하는 오류 정보 오류입니다.
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_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가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다.
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가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다.
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)

삭제 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다.

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가 포함됩니다.