The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

Cette page a été traduite par l'API Cloud Translation.

Configurer l'accès à l'API

Voici comment configurer l'accès à l'API Data Manager avec un SDK ou REST.

Configurer l'interface de ligne de commande Google Cloud

Installez et initialisez l'interface de ligne de commande Google Cloud.
Pour vous assurer que vos composants gcloud sont à jour, exécutez la commande suivante.
```
gcloud components update
```
(Facultatif) Utilisez la commande gcloud config set pour définir un projet et une région par défaut.

Configurer l'authentification

Vous pouvez vous authentifier avec des comptes utilisateur et des comptes de service:

Comptes utilisateur: représentent les personnes qui interagissent directement avec les API et les services Google.
Comptes de service: représentent les applications, et non les utilisateurs, en tant qu'utilisateurs. Ils permettent à vos applications de gérer l'authentification et l'autorisation. Par exemple, si une application doit accéder aux ressources Google Cloud.

Votre intégration peut utiliser les identifiants par défaut de l'application (ADC) pour rechercher automatiquement des identifiants dans l'environnement. Vous n'avez pas besoin de modifier le code client pour l'authentification.

Choisissez Compte utilisateur ou Compte de service pour configurer l'ADC:

Pour en savoir plus sur l'authentification et les identifiants de votre application, consultez les pages Méthodes d'authentification chez Google et Configurer les identifiants par défaut de l'application.

Configurer l'accès au compte d'exploitation

Accordez à l'adresse e-mail associée à votre compte utilisateur ou de service l'accès à Destination.

Configurer le SDK pour votre langage de programmation

Sur votre machine locale, installez le SDK de votre choix:

REST

Remplacez les espaces réservés de l'exemple suivant, tels que OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID et AUDIENCE_ID, par les valeurs de votre compte et de votre destination.
Remplacez PROJECT_ID par l'ID de votre compte Google Cloud.

Copiez l'exemple dans la ligne de commande pour envoyer la requête.

Supprimez l'attribut linkedAccount de l'entrée dans destinations si vous n'accédez pas à operationAccount à l'aide d'un lien produit établi.

#!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- &lt;&lt;EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

Java

Téléchargez et décompressez google-cloud-ads-datamanager-v1-java.tar.gz.
Accédez au répertoire google-cloud-ads-datamanager-v1-java.
Exécutez la commande suivante pour compiler et publier la bibliothèque dans votre dépôt Maven local afin de l'utiliser avec Maven ou Gradle.
```
./gradlew -Pversion=0.1.0 install
```

Dans votre projet Java, déclarez une dépendance sur la bibliothèque de l'API Data Manager.

Gradle:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.0'

Maven:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.0</version>
</dependency>

Facultatif. Obtenez la bibliothèque d'utilitaires et les exemples de code.
1. Téléchargez et extrayez data-manager-java.tar.gz.
2. Accédez au répertoire data-manager-java.
3. Pour Maven ou Gradle, exécutez la commande suivante. Cette commande compile et publie la bibliothèque d'utilitaires dans votre dépôt Maven local.
```
./gradlew data-manager-util:install
```
4. Dans votre projet Java, déclarez une dépendance à la bibliothèque d'utilitaires.
  
  Gradle:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  Maven:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. Pour mettre en forme et chiffrer les données, utilisez les utilitaires UserDataFormatter et Encrypter dans votre projet Java.
6. Parcourez les exemples de code dans le sous-répertoire data-manager-samples. Pour exécuter un exemple à partir de la ligne de commande, utilisez la tâche Gradle run.
  
  Par exemple, la commande suivante exécute l'exemple IngestAudienceMembers et affiche une déclaration d'utilisation:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  Pour vous aider à vous lancer avec des exemples de données, utilisez le fichier situé à l'emplacement data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Python

Téléchargez ads-datamanager-v1-py.tar.gz.
Accédez au répertoire du téléchargement.
Exécutez la commande suivante pour créer la bibliothèque et la rendre disponible pour d'autres projets dans le même environnement Python:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
Dans votre projet Python, déclarez une dépendance sur la bibliothèque de l'API Data Manager. Par exemple, si vous utilisez un fichier requirements.txt dans votre projet, ajoutez la ligne suivante au fichier:
```
google-ads-data-manager=0.1.0
```
Facultatif. Obtenez la bibliothèque d'utilitaires et les exemples de code.
1. Téléchargez et extrayez data-manager-python.tar.gz.
2. Accédez au répertoire data-manager-python.
3. Pour installer la bibliothèque d'utilitaires dans votre environnement Python, exécutez la commande suivante:
```
pip install .
```
4. Dans votre projet Python, déclarez une dépendance à la bibliothèque d'utilitaires. Par exemple, si vous utilisez un fichier requirements.txt dans votre projet, ajoutez la ligne suivante au fichier:
```
google-ads-data-manager-util=0.1.0
```
5. Pour mettre en forme et chiffrer les données, utilisez les utilitaires Formatter et Encrypter dans votre projet Python.
6. Parcourez les exemples de code dans le sous-répertoire samples. Transmettez l'argument --help lorsque vous exécutez un exemple pour imprimer une instruction d'utilisation avec les paramètres attendus.
  
  Pour vous aider à vous lancer avec des exemples de données, utilisez le fichier situé à l'emplacement samples/sampledata/audience_members_1.csv.

Node.js

Téléchargez et extrayez ads-datamanager-v1-nodejs.tar.gz.
Accédez au répertoire ads-datamanager-v1-nodejs.
Exécutez les commandes suivantes pour compiler et empaqueter la bibliothèque dans un fichier .tgz à utiliser avec npm.
```
npm install
npm pack
```
Les commandes génèrent une archive nommée google-cloud-datamanager-0.1.0.tgz.
Dans votre projet Node.js, déclarez une dépendance sur la bibliothèque d'API Data Manager en ajoutant une entrée dependencies pour le chemin d'accès complet et le nom de fichier du fichier google-cloud-datamanager-0.1.0.tgz.

PHP

Téléchargez et extrayez google-cloud-ads-datamanager-v1-php.tar.gz.
Accédez au répertoire google-cloud-ads-datamanager-v1-php.
Exécutez la commande suivante pour résoudre les dépendances de la bibliothèque:
```
composer update --prefer-dist
```
Dans le fichier composer.json de votre projet PHP sur le même hôte, déclarez une dépendance sur la bibliothèque de l'API Data Manager en procédant comme suit:

a. Ajoutez une section repositories qui pointe vers l'emplacement du répertoire google-cloud-ads-datamanager-v1-php.
```
 "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]
```
b. Déclarez une dépendance à la bibliothèque d'API Data Manager.
```
 "require": {
    "googleads/data-manager": "^0.1.0"
 }
```