Method: requestStatus.retrieve

Gets the status of a request given request id.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
requestId

string

Required. Required. The request ID of the Data Manager API request.

Request body

The request body must be empty.

Response body

Response from the RetrieveRequestStatusRequest.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "requestStatusPerDestination": [
    {
      object (RequestStatusPerDestination)
    }
  ]
}
Fields
requestStatusPerDestination[]

object (RequestStatusPerDestination)

A list of request statuses per destination. The order of the statuses matches the order of the destinations in the original request.

Authorization scopes

Requires the following OAuth scope:

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

RequestStatusPerDestination

A request status per destination.

JSON representation 
{
  "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.
}
Fields
destination

object (Destination)

A destination within a DM API request.
requestStatus

enum (RequestStatus)

The request status of the destination.
errorInfo

object (ErrorInfo)

An error info error containing the error reason and error counts related to the upload.
warningInfo

object (WarningInfo)

A warning info containing the warning reason and warning counts related to the upload.
Union field status. The status of the destination. status can be only one of the following:
audienceMembersIngestionStatus

object (IngestAudienceMembersStatus)

The status of the ingest audience members request.
eventsIngestionStatus

object (IngestEventsStatus)

The status of the ingest events request.
audienceMembersRemovalStatus

object (RemoveAudienceMembersStatus)

The status of the remove audience members request.

RequestStatus

The request status.

Enums
REQUEST_STATUS_UNKNOWN The request status is unknown.
SUCCESS The request succeeded.
PROCESSING The request is processing.
FAILED The request failed.
PARTIAL_SUCCESS The request partially succeeded.

ErrorInfo

Error counts for each type of error.

JSON representation 
{
  "errorCounts": [
    {
      object (ErrorCount)
    }
  ]
}
Fields
errorCounts[]

object (ErrorCount)

A list of errors and counts per error reason. May not be populated in all cases.

ErrorCount

The error count for a given error reason.

JSON representation 
{
  "recordCount": string,
  "reason": enum (ProcessingErrorReason)
}
Fields
recordCount

string (int64 format)

The count of records that failed to upload for a given reason.
reason

enum (ProcessingErrorReason)

The error reason of the failed records.

ProcessingErrorReason

The processing error reason.

Enums
PROCESSING_ERROR_REASON_UNSPECIFIED The processing error reason is unknown.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE The custom variable is invalid.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED The status of the custom variable is not enabled.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD The conversion is older than max supported age.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID A conversion with the same GCLID and conversion time already exists in the system.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID A conversion with the same order id and conversion action combination was already uploaded.
PROCESSING_ERROR_REASON_INVALID_GBRAID The gbraid could not be decoded.
PROCESSING_ERROR_REASON_INVALID_GCLID The google click ID could not be decoded.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Merchant id contains non-digit characters.
PROCESSING_ERROR_REASON_INVALID_WBRAID The wbraid could not be decoded.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Internal error.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Enhanced conversions terms are not signed in the destination account.
PROCESSING_ERROR_REASON_INVALID_EVENT The event is invalid.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS The matched transactions are less than the minimum threshold.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS The transactions are less than the minimum threshold.
PROCESSING_ERROR_REASON_INVALID_FORMAT The event has format error.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR The event has a decryption error.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR The DEK failed to be decrypted.
PROCESSING_ERROR_REASON_INVALID_WIP The WIP is formatted incorrectly or the WIP does not exist.
PROCESSING_ERROR_REASON_INVALID_KEK The KEK cannot decrypt data because it is the wrong KEK, or it does not exist.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED The WIP could not be used because it was rejected by its attestation condition.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED The system did not have the permissions needed to access the KEK.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Failed to decrypt the UserIdentifier data using the DEK.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER The user attempted to ingest events with an ad identifier that isn't from the operating account's ads.

WarningInfo

Warning counts for each type of warning.

JSON representation 
{
  "warningCounts": [
    {
      object (WarningCount)
    }
  ]
}
Fields
warningCounts[]

object (WarningCount)

A list of warnings and counts per warning reason.

WarningCount

The warning count for a given warning reason.

JSON representation 
{
  "recordCount": string,
  "reason": enum (ProcessingWarningReason)
}
Fields
recordCount

string (int64 format)

The count of records that have a warning.
reason

enum (ProcessingWarningReason)

The warning reason.

ProcessingWarningReason

The processing warning reason.

Enums
PROCESSING_WARNING_REASON_UNSPECIFIED The processing warning reason is unknown.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED The system did not have the permissions needed to access the KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR The DEK failed to be decrypted.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR The event has a decryption error.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED The WIP could not be used because it was rejected by its attestation condition.
PROCESSING_WARNING_REASON_INVALID_WIP The WIP is formatted incorrectly or the WIP does not exist.
PROCESSING_WARNING_REASON_INVALID_KEK The KEK cannot decrypt data because it is the wrong KEK, or it does not exist.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Failed to decrypt th UserIdentifier data using the DEK.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Internal error.

IngestAudienceMembersStatus

The status of the ingest audience members request.

JSON representation 
{

  // 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.
}
Fields
Union field status. The status of the audience members ingestion to the destination. status can be only one of the following:
userDataIngestionStatus

object (IngestUserDataStatus)

The status of the user data ingestion to the destination.
mobileDataIngestionStatus

object (IngestMobileDataStatus)

The status of the mobile data ingestion to the destination.
pairDataIngestionStatus

object (IngestPairDataStatus)

The status of the pair data ingestion to the destination.

IngestUserDataStatus

The status of the user data ingestion to the destination containing stats related to the ingestion.

JSON representation 
{
  "recordCount": string,
  "userIdentifierCount": string,
  "uploadMatchRateRange": enum (MatchRateRange)
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.
userIdentifierCount

string (int64 format)

The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not.
uploadMatchRateRange

enum (MatchRateRange)

The match rate range of the upload.

MatchRateRange

The match rate range of the upload or userlist.

Enums
MATCH_RATE_RANGE_UNKNOWN The match rate range is unknown.
MATCH_RATE_RANGE_NOT_ELIGIBLE The match rate range is not eligible.
MATCH_RATE_RANGE_LESS_THAN_20 The match rate range is less than 20% (in the interval [0, 20)).
MATCH_RATE_RANGE_20_TO_30 The match rate range is between 20% and 30% (in the interval [20, 31)).
MATCH_RATE_RANGE_31_TO_40 The match rate range is between 31% and 40% (in the interval [31, 41)).
MATCH_RATE_RANGE_41_TO_50 The match rate range is between 41% and 50% (in the interval [41, 51)).
MATCH_RATE_RANGE_51_TO_60 The match rate range is between 51% and 60% (in the interval [51, 61).
MATCH_RATE_RANGE_61_TO_70 The match rate range is between 61% and 70% (in the interval [61, 71)).
MATCH_RATE_RANGE_71_TO_80 The match rate range is between 71% and 80% (in the interval [71, 81)).
MATCH_RATE_RANGE_81_TO_90 The match rate range is between 81% and 90% (in the interval [81, 91)).
MATCH_RATE_RANGE_91_TO_100

The match rate range is between 91% and 100% (in the interval [91, 100]).

IngestMobileDataStatus

The status of the mobile data ingestion to the destination containing stats related to the ingestion.

JSON representation 
{
  "recordCount": string,
  "mobileIdCount": string
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.
mobileIdCount

string (int64 format)

The total count of mobile ids sent in the upload request for the destination. Includes all mobile ids in the request, regardless of whether they were successfully ingested or not.

IngestPairDataStatus

The status of the pair data ingestion to the destination containing stats related to the ingestion.

JSON representation 
{
  "recordCount": string,
  "pairIdCount": string
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.
pairIdCount

string (int64 format)

The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not.

IngestEventsStatus

The status of the events ingestion to the destination.

JSON representation 
{
  "recordCount": string
}
Fields
recordCount

string (int64 format)

The total count of events sent in the upload request. Includes all events in the request, regardless of whether they were successfully ingested or not.

RemoveAudienceMembersStatus

The status of the remove audience members request.

JSON representation 
{

  // 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.
}
Fields
Union field status. The status of the audience members removal from the destination. status can be only one of the following:
userDataRemovalStatus

object (RemoveUserDataStatus)

The status of the user data removal from the destination.
mobileDataRemovalStatus

object (RemoveMobileDataStatus)

The status of the mobile data removal from the destination.
pairDataRemovalStatus

object (RemovePairDataStatus)

The status of the pair data removal from the destination.

RemoveUserDataStatus

The status of the user data removal from the destination.

JSON representation 
{
  "recordCount": string,
  "userIdentifierCount": string
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.
userIdentifierCount

string (int64 format)

The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not.

RemoveMobileDataStatus

The status of the mobile data removal from the destination.

JSON representation 
{
  "recordCount": string,
  "mobileIdCount": string
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.
mobileIdCount

string (int64 format)

The total count of mobile Ids sent in the removal request. Includes all mobile ids in the request, regardless of whether they were successfully removed or not.

RemovePairDataStatus

The status of the pair data removal from the destination.

JSON representation 
{
  "recordCount": string,
  "pairIdCount": string
}
Fields
recordCount

string (int64 format)

The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.
pairIdCount

string (int64 format)

The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not.