- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- RequestStatusPerDestination
- RequestStatus
- ErrorInfo
- ErrorCount
- ProcessingErrorReason
- WarningInfo
- WarningCount
- ProcessingWarningReason
- IngestAudienceMembersStatus
- IngestUserDataStatus
- MatchRateRange
- IngestMobileDataStatus
- IngestPairDataStatus
- IngestUserIdDataStatus
- IngestPpidDataStatus
- IngestCompositeDataStatus
- DataTypeCount
- DataType
- IngestEventsStatus
- RemoveAudienceMembersStatus
- RemoveUserDataStatus
- RemoveMobileDataStatus
- RemovePairDataStatus
- RemoveUserIdDataStatus
- RemovePpidDataStatus
- RemoveCompositeDataStatus
- Faça um teste
Recebe o status de uma solicitação com o ID dela.
Solicitação HTTP
GET https://datamanager.googleapis.com/v1/requestStatus:retrieve
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros | |
|---|---|
requestId |
Obrigatório. Obrigatório. O ID da solicitação da API Data Manager. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta do RetrieveRequestStatusRequest.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
|---|
{
"requestStatusPerDestination": [
{
object ( |
| Campos | |
|---|---|
requestStatusPerDestination[] |
Uma lista de status de solicitação por destino. A ordem dos status corresponde à ordem dos destinos na solicitação original. |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/datamanager
RequestStatusPerDestination
Um status de solicitação por destino.
| Representação JSON |
|---|
{ "destination": { object ( |
| Campos | |
|---|---|
destination |
Um destino em uma solicitação de API DM. |
requestStatus |
O status da solicitação do destino. |
errorInfo |
Um erro de informações que contém o motivo e as contagens de erros relacionados ao upload. Preenchido apenas se o |
warningInfo |
Informações de aviso que contêm o motivo e a quantidade de avisos relacionados ao envio. Esse campo não é preenchido enquanto a solicitação tem |
Campo de união status. O status do destino. status pode ser apenas de um dos tipos a seguir: |
|
audienceMembersIngestionStatus |
O status da solicitação de inclusão de membros do público-alvo. |
eventsIngestionStatus |
O status da solicitação de eventos de ingestão. |
audienceMembersRemovalStatus |
O status da solicitação de remoção de participantes do público-alvo. |
RequestStatus
O status da solicitação.
| Tipos enumerados | |
|---|---|
REQUEST_STATUS_UNKNOWN |
O status da solicitação é desconhecido. |
SUCCESS |
O processamento foi concluído para todos os registros sem erros. No entanto, pode haver avisos no campo . |
PROCESSING |
A solicitação está sendo processada. |
FAILED |
O processamento falhou para todos os registros. Verifique o campo para detalhes do erro e o campo para detalhes do aviso. |
PARTIAL_SUCCESS |
O processamento foi concluído sem erros para alguns registros, mas falhou com erros para outros. Verifique o campo para detalhes do erro e o campo para detalhes do aviso. |
ErrorInfo
Contagens de erros para cada tipo de erro.
| Representação JSON |
|---|
{
"errorCounts": [
{
object ( |
| Campos | |
|---|---|
errorCounts[] |
Uma lista de erros e contagens por motivo de erro. Talvez não seja preenchido em todos os casos. |
ErrorCount
A contagem de erros para um determinado motivo.
| Representação JSON |
|---|
{
"recordCount": string,
"reason": enum ( |
| Campos | |
|---|---|
recordCount |
A contagem de registros que não foram enviados por um determinado motivo. |
reason |
O motivo do erro dos registros com falha. |
ProcessingErrorReason
O motivo do erro de processamento. Novos motivos podem ser adicionados no futuro.
| Tipos enumerados | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
O motivo do erro de processamento é desconhecido. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
A variável personalizada é inválida. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
O status da variável personalizada não está ativado. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
A conversão é mais antiga que a idade máxima aceita. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
Os dados do usuário de publicidade são negados pelo usuário ou nas configurações padrão do anunciante. |
PROCESSING_ERROR_REASON_NO_CONSENT |
O anunciante não deu consentimento de terceiros para os serviços principais da plataforma do Google Ads. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Não foi possível determinar o consentimento geral (determinado pelo consentimento no nível da linha, no nível da solicitação e nas configurações da conta) para este usuário. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Já existe uma conversão com os mesmos valores de GCLID e data/hora no sistema. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Uma conversão com a mesma combinação de ID do pedido e ação de conversão já foi enviada. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Não foi possível decodificar o gbraid. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Não foi possível decodificar o ID de clique do Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
O ID do comerciante contém caracteres que não são dígitos. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Não foi possível decodificar o wbraid. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Erro interno. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Os termos das conversões otimizadas não foram assinados na conta de destino. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
O evento é inválido. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
O número de transações correspondentes é menor que o limite mínimo. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
As transações estão abaixo do limite mínimo. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
O evento tem um erro de formato. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
O evento tem um erro de descriptografia. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Não foi possível descriptografar a DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
O WIP está formatado incorretamente ou não existe. |
PROCESSING_ERROR_REASON_INVALID_KEK |
A KEK não pode descriptografar dados porque é a KEK errada ou não existe. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
O WIP não pôde ser usado porque foi rejeitado pela condição de atestação. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
O sistema não tinha as permissões necessárias para acessar a KEK. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
O sistema não conseguiu fazer a autenticação com a AWS. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Não foi possível descriptografar os dados UserIdentifier usando a DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
O usuário tentou ingerir eventos com um identificador de publicidade que não é dos anúncios da conta operacional. |
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID |
As ações de conversão de uma por clique não podem ser usadas com BRAIDs. |
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND |
Não foi possível encontrar o ID da correspondência. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID |
Não foi possível encontrar o ID do usuário para o ID da partida. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID |
Não foi possível encontrar o ID do usuário para o GCLID. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID |
Não foi possível encontrar o ID do usuário para o DCLID. |
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS |
Há identificadores de publicidade inválidos. |
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT |
O formato do ID do dispositivo móvel é inválido. |
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND |
Não foi possível encontrar as conversões originais. |
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR |
Não é possível decodificar o ID do evento (dclid ou ID de impressão). |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID |
Não foi possível encontrar o ID do usuário para o ID de impressão especificado. |
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND |
Não foi possível encontrar o ID do usuário. |
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK |
O carimbo de data/hora do evento é anterior ao clique associado. |
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK |
O clique ocorreu muito recentemente. |
PROCESSING_ERROR_REASON_INVALID_CLICK |
O evento não pode ser atribuído a um clique (GCLID). Isso pode acontecer, por exemplo, se o clique não veio de uma campanha do Google Ads. |
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK |
O clique do evento não está associado ao do destino. |
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND |
Não foi possível encontrar um clique correspondente que corresponda aos atributos fornecidos. |
WarningInfo
Contagens de avisos para cada tipo.
| Representação JSON |
|---|
{
"warningCounts": [
{
object ( |
| Campos | |
|---|---|
warningCounts[] |
Uma lista de alertas e contagens por motivo de alerta. |
WarningCount
A contagem de avisos para um determinado motivo.
| Representação JSON |
|---|
{
"recordCount": string,
"reason": enum ( |
| Campos | |
|---|---|
recordCount |
A contagem de registros que têm um aviso. |
reason |
O motivo do aviso. |
ProcessingWarningReason
O motivo do aviso de processamento.
| Tipos enumerados | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
O motivo do aviso de processamento é desconhecido. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
O sistema não tinha as permissões necessárias para acessar a KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Não foi possível descriptografar a DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
O evento tem um erro de descriptografia. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
O WIP não pôde ser usado porque foi rejeitado pela condição de atestação. |
PROCESSING_WARNING_REASON_INVALID_WIP |
O WIP está formatado incorretamente ou não existe. |
PROCESSING_WARNING_REASON_INVALID_KEK |
A KEK não pode descriptografar dados porque é a KEK errada ou não existe. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Não foi possível descriptografar os dados UserIdentifier usando a DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Erro interno. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
O sistema não conseguiu fazer a autenticação com a AWS. |
IngestAudienceMembersStatus
O status da solicitação de inclusão de membros do público-alvo.
| Representação JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de união status. O status da ingestão de participantes do público-alvo no destino. status pode ser apenas de um dos tipos a seguir: |
|
userDataIngestionStatus |
O status da ingestão de dados do usuário no destino. |
mobileDataIngestionStatus |
O status da ingestão de dados móveis no destino. |
pairDataIngestionStatus |
O status da ingestão de dados do par no destino. |
userIdDataIngestionStatus |
O status da ingestão de dados de ID do usuário no destino. |
ppidDataIngestionStatus |
O status da ingestão de dados de PPID no destino. |
compositeDataIngestionStatus |
O status da ingestão de dados compostos no destino. |
IngestUserDataStatus
O status da ingestão de dados do usuário no destino com estatísticas relacionadas a ela.
| Representação JSON |
|---|
{
"recordCount": string,
"userIdentifierCount": string,
"uploadMatchRateRange": enum ( |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
userIdentifierCount |
A contagem total de identificadores de usuário enviados na solicitação de upload para o destino. Inclui todos os identificadores de usuário na solicitação, independentemente de terem sido ingeridos ou não. |
uploadMatchRateRange |
O intervalo da taxa de correspondência do upload. |
MatchRateRange
O intervalo da taxa de correspondência do upload ou da lista de usuários.
| Tipos enumerados | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
O intervalo da taxa de correspondência é desconhecido. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
O intervalo de taxa de correspondência não está qualificado. |
MATCH_RATE_RANGE_LESS_THAN_20 |
O intervalo da taxa de correspondência é inferior a 20% (no intervalo [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
A taxa de correspondência está entre 20% e 30% (no intervalo [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
O intervalo da taxa de correspondência está entre 31% e 40% (no intervalo [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
O intervalo da taxa de correspondência está entre 41% e 50% (no intervalo [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
O intervalo da taxa de correspondência está entre 51% e 60% (no intervalo [51, 61). |
MATCH_RATE_RANGE_61_TO_70 |
O intervalo da taxa de correspondência está entre 61% e 70% (no intervalo [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
O intervalo da taxa de correspondência é entre 71% e 80% (no intervalo [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
O intervalo da taxa de correspondência está entre 81% e 90% (no intervalo [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
O intervalo da taxa de correspondência é entre 91% e 100% (no intervalo |
IngestMobileDataStatus
O status da ingestão de dados móveis no destino que contém estatísticas relacionadas a ela.
| Representação JSON |
|---|
{ "recordCount": string, "mobileIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
mobileIdCount |
A contagem total de IDs de dispositivos móveis enviados na solicitação de upload para o destino. Inclui todos os IDs de dispositivos móveis na solicitação, independentemente de terem sido ingeridos ou não. |
IngestPairDataStatus
O status da ingestão de dados do par no destino com estatísticas relacionadas à ingestão.
| Representação JSON |
|---|
{ "recordCount": string, "pairIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
pairIdCount |
A contagem total de IDs de pares enviados na solicitação de upload para o destino. Inclui todos os IDs de pares na solicitação, independentemente de terem sido ingeridos ou não. |
IngestUserIdDataStatus
O status da ingestão de dados de ID do usuário no destino que contém estatísticas relacionadas à ingestão.
| Representação JSON |
|---|
{ "recordCount": string, "userIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
userIdCount |
A contagem total de IDs de usuário enviados na solicitação de upload para o destino. Inclui todos os IDs de usuário na solicitação, independentemente de terem sido ingeridos ou não. |
IngestPpidDataStatus
O status da ingestão de dados de PPID no destino com estatísticas relacionadas a ela.
| Representação JSON |
|---|
{ "recordCount": string, "ppidCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
ppidCount |
A contagem total de PPIDs enviados na solicitação de upload para o destino. Inclui todos os PPIDs na solicitação, independentemente de terem sido ingeridos ou não. |
IngestCompositeDataStatus
O status da ingestão de dados combinados no destino, com estatísticas relacionadas a ela.
| Representação JSON |
|---|
{ "recordCount": string, "dataTypeCounts": [ { object ( |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de upload para o destino. Inclui todos os membros do público-alvo na solicitação, independentemente de terem sido ingeridos ou não. |
dataTypeCounts[] |
A contagem total de tipos de dados enviados na solicitação de upload para o destino, dividida por tipo de dado. Inclui todos os tipos de dados na solicitação, independentemente de terem sido ingeridos ou não. |
uploadMatchRateRange |
O intervalo da taxa de correspondência do upload. |
DataTypeCount
A contagem de um tipo de dados específico.
| Representação JSON |
|---|
{
"type": enum ( |
| Campos | |
|---|---|
type |
O tipo de dados. |
count |
A contagem para esse tipo de dados. |
DataType
O tipo de dados.
| Tipos enumerados | |
|---|---|
DATA_TYPE_UNSPECIFIED |
O tipo de dados não foi especificado. |
EMAIL |
Os dados são um endereço de e-mail. |
PHONE_NUMBER |
Os dados são um número de telefone. |
ADDRESS |
Os dados são um endereço físico. |
IP_ADDRESS |
Os dados são um endereço IP. |
IngestEventsStatus
O status da ingestão de eventos no destino.
| Representação JSON |
|---|
{ "recordCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de eventos enviados na solicitação de upload. Inclui todos os eventos na solicitação, independentemente de terem sido ingeridos ou não. |
RemoveAudienceMembersStatus
O status da solicitação de remoção de participantes do público-alvo.
| Representação JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de união status. O status da remoção dos participantes do público-alvo do destino. status pode ser apenas de um dos tipos a seguir: |
|
userDataRemovalStatus |
O status da remoção dos dados do usuário do destino. |
mobileDataRemovalStatus |
O status da remoção de dados móveis do destino. |
pairDataRemovalStatus |
O status da remoção dos dados do par do destino. |
userIdDataRemovalStatus |
O status da remoção dos dados de ID do usuário do destino. |
ppidDataRemovalStatus |
O status da remoção dos dados de PPID do destino. |
compositeDataRemovalStatus |
O status da remoção de dados compostos do destino. |
RemoveUserDataStatus
O status da remoção dos dados do usuário do destino.
| Representação JSON |
|---|
{ "recordCount": string, "userIdentifierCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
userIdentifierCount |
A contagem total de identificadores de usuário enviados na solicitação de remoção. Inclui todos os identificadores de usuário na solicitação, independentemente de terem sido removidos ou não. |
RemoveMobileDataStatus
O status da remoção de dados móveis do destino.
| Representação JSON |
|---|
{ "recordCount": string, "mobileIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
mobileIdCount |
A contagem total de IDs de dispositivos móveis enviados na solicitação de remoção. Inclui todos os IDs de dispositivos móveis na solicitação, independente de terem sido removidos ou não. |
RemovePairDataStatus
O status da remoção dos dados do par do destino.
| Representação JSON |
|---|
{ "recordCount": string, "pairIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
pairIdCount |
A contagem total de IDs de pares enviados na solicitação de remoção. Inclui todos os IDs de pares na solicitação, independente de terem sido removidos ou não. |
RemoveUserIdDataStatus
O status da remoção dos dados de ID do usuário do destino.
| Representação JSON |
|---|
{ "recordCount": string, "userIdCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
userIdCount |
A contagem total de IDs de usuário enviados na solicitação de remoção. Inclui todos os IDs de usuário na solicitação, independente de terem sido removidos ou não. |
RemovePpidDataStatus
O status da remoção dos dados de PPID do destino.
| Representação JSON |
|---|
{ "recordCount": string, "ppidCount": string } |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
ppidCount |
A contagem total de PPIDs enviados na solicitação de remoção. Inclui todos os PPIDs na solicitação, independentemente de terem sido removidos ou não. |
RemoveCompositeDataStatus
O status da remoção de dados compostos do destino.
| Representação JSON |
|---|
{
"recordCount": string,
"dataTypeCounts": [
{
object ( |
| Campos | |
|---|---|
recordCount |
A contagem total de membros do público-alvo enviada na solicitação de remoção. Inclui todos os membros do público-alvo na solicitação, independente de terem sido removidos ou não. |
dataTypeCounts[] |
A contagem total de tipos de dados enviados na solicitação de remoção, dividida por tipo de dado. Inclui todos os tipos de dados na solicitação, independentemente de terem sido removidos ou não. |