Method: customers.uploadUserData

Importe les données utilisateur données.

Liste des erreurs générées: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. Identifiant du client pour lequel vous souhaitez mettre à jour les données utilisateur.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
operations[]

object (UserDataOperation)

Obligatoire. Liste des opérations à effectuer.

Champ d'union metadata. Métadonnées de la requête. metadata ne peut être qu'un des éléments suivants :
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Métadonnées pour la mise à jour des données d'une liste d'utilisateurs de ciblage par liste de clients.

Corps de la réponse

Le message de réponse pour UserDataService.UploadUserData. Les importations effectuées via ce service ne seront pas visibles dans la section "Membres du segment" de la liste de ciblage par liste de clients dans l'interface utilisateur Google Ads.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Champs
uploadDateTime

string

Date et heure de réception de la requête par l'API, au format "aaaa-mm-jj hh:mm:ss+|-hh:mm", par exemple, "2019-01-01 12:32:45-08:00".

receivedOperationsCount

integer

Nombre d'opérations d'importation de données reçues par l'API.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

UserDataOperation

Opération à effectuer pour l'élément UploadUserDataRequest.

Représentation 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.
}
Champs
Champ d'union operation. Opération à effectuer pour l'élément UploadUserDataRequest. operation ne peut être qu'un des éléments suivants :
create

object (UserData)

Liste des données utilisateur à ajouter à la liste d'utilisateurs.

remove

object (UserData)

Liste des données utilisateur à supprimer de la liste d'utilisateurs.