Method: customers.uploadUserData

Sube los datos del usuario especificados.

Lista de errores arrojados: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. Es el ID del cliente para el que se actualizarán los datos del usuario.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)

Obligatorio. Es la lista de operaciones que se deben realizar.

Campo de unión metadata. Metadatos de la solicitud. Las direcciones (metadata) solo pueden ser una de las siguientes opciones:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadatos para las actualizaciones de datos de una lista de usuarios de Segmentación por clientes.

Cuerpo de la respuesta

Mensaje de respuesta para UserDataService.UploadUserData Las cargas realizadas a través de este servicio no se podrán ver en la sección "Miembros del segmento" de la lista de Segmentación por clientes en la IU de Google Ads.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Campos
uploadDateTime

string

Indica la fecha y hora en la que la API recibió la solicitud, con el formato “aaaa-mm-dd hh:mm:ss+|-hh:mm”, por ejemplo, “2019-01-01 12:32:45-08:00”.

receivedOperationsCount

integer

Cantidad de operaciones de carga de datos que recibió la API.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

UserDataOperation

Operación que se realizará para UploadUserDataRequest.

Representación 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ón operation. Operación que se realizará para UploadUserDataRequest. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
create

object (UserData)

Es la lista de datos del usuario que se agregará a la lista de usuarios.

remove

object (UserData)

Es la lista de datos del usuario que se quitarán de la lista.