Method: customers.uploadUserData

Faz o upload dos dados do usuário fornecidos.

Lista de erros gerados: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Solicitação HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadUserData

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente sobre o qual atualizar os dados do usuário.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campos
operations[]

object (UserDataOperation)

Obrigatório. A lista de operações a serem realizadas.
Campo de união metadata. Metadados da solicitação. metadata pode ser apenas de um dos tipos a seguir:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadados para atualizações de dados em uma lista de usuários da Segmentação por lista de clientes.

Corpo da resposta

A mensagem de resposta para UserDataService.UploadUserData uploads feitos por esse serviço não vai aparecer na seção "Membros do segmento" da Segmentação por lista de clientes na interface do Google Ads.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Campos
uploadDateTime

string

A data e hora em que a solicitação foi recebida pela API, no formato "aaaa-mm-dd hh:mm:ss+|-hh:mm", por exemplo, "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

Número de operações de dados de upload recebidas pela API.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

UserDataOperation

Operação a ser feita para UploadUserDataRequest.

Representação JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Campos
Campo de união operation. Operação a ser feita para UploadUserDataRequest. operation pode ser apenas de um dos tipos a seguir:
create

object (UserData)

A lista de dados do usuário a serem anexados à lista de usuários.
remove

object (UserData)

A lista de dados do usuário a serem removidos da lista de usuários.