Installa una libreria client

Ecco come installare e configurare una libreria client o REST.

Prerequisiti

Prima di installare una libreria client, completa i passaggi descritti in Configurare l'accesso all'API, inclusa la configurazione delle credenziali predefinite dell'applicazione (ADC).

Installa la libreria

Sulla tua macchina locale, installa la libreria client che preferisci:

REST

Scegli il tipo di procedura di configurazione che vuoi seguire:

Inserzionista Partner di dati

1. Aggiorna i segnaposto nel seguente esempio, ad esempio OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID e AUDIENCE_ID, con i valori per il tuo account e la tua destinazione.
2. Sostituisci PROJECT_ID con l'ID del tuo Google Cloud.

3. Copia l'esempio nella riga di comando per inviare la richiesta.

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account, the command that specifies
   # --scopes fails. This sample falls back to the command without the
   # --scopes argument.
   DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
     gcloud auth application-default print-access-token)"
   
   # Fetches and prints the scope information for the access token. If you
   # get scope-related errors when you send the request in the next step,
   # verify that this output includes the Data Manager API scope:
   #   https://www.googleapis.com/auth/datamanager
   curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"
   
   # Sends the request.
   curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
     --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
     --header "x-goog-user-project: PROJECT_ID" \
     --header "Content-Type: application/json" \
     --data @- <<EOF
   
   
       {
     "destinations": [
       {
         "operatingAccount": {
           "accountType": "OPERATING_ACCOUNT_TYPE",
           "accountId": "OPERATING_ACCOUNT_ID"
         },
         "loginAccount": {
           "accountType": "LOGIN_ACCOUNT_TYPE",
           "accountId": "LOGIN_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
   

.NET

Installa la libreria client

Segui le istruzioni nella guida all'installazione della libreria client.NET per aggiungere una dipendenza alla libreria client nel tuo progetto.

(Facoltativo) Ottieni la libreria di utilità e gli esempi di codice.

1. Clona il repository GitHub.

   git clone https://github.com/googleads/data-manager-dotnet.git
   

2. Nel tuo progetto .NET, dichiara una dipendenza ProjectReference dalla libreria di utilità. Sostituisci PATH_TO_UTILITY_LIBRARY con la posizione in cui hai clonato il repository data-manager-dotnet.

   <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
   

3. Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto .NET.

4. Sfoglia gli esempi di codice nella sottodirectory samples o su GitHub.

   Passa alla directory samples e utilizza dotnet run per ottenere l'elenco dei campioni disponibili.

   dotnet run
   

   Passa l'argomento --help quando esegui un esempio per stampare un'istruzione di utilizzo con i parametri previsti.

   dotnet run -- ingest-audience-members --help
   

   Per iniziare con alcuni dati di esempio, utilizza il file all'indirizzo samples/sampledata/audience_members_1.csv.

Java

Installa la libreria client

Segui le istruzioni della guida all'installazione della libreria client Java per aggiungere una dipendenza alla libreria client nel tuo progetto.

(Facoltativo) Ottieni la libreria di utilità e gli esempi di codice.

1. Clona il repository GitHub.

   git clone https://github.com/googleads/data-manager-java.git
   

2. Vai alla directory data-manager-java.

3. Crea e pubblica la libreria di utilità nel repository Maven locale.

   ./gradlew data-manager-util:install
   

4. Nel tuo progetto Java, dichiara una dipendenza dalla libreria di utilità.

   Gradle:

   implementation 'com.google.api-ads:data-manager-util:0.2.0'
   

   Maven:

   <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>data-manager-util</artifactId>
      <version>0.2.0</version>
   </dependency>
   

5. Per formattare e criptare i dati, utilizza le utilità UserDataFormatter e Encrypter nel tuo progetto Java.

6. Sfoglia gli esempi di codice nella sottodirectory data-manager-samples o su GitHub. Per eseguire un esempio dalla riga di comando, utilizza l'attività Gradle run.

   Ad esempio, il seguente comando esegue l'esempio IngestAudienceMembers e stampa un'istruzione di utilizzo:

   ./gradlew data-manager-samples:run \
      --args='IngestAudienceMembers --help'
   

   Per iniziare con alcuni dati di esempio, utilizza il file all'indirizzo data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

Installa la libreria client

Segui le istruzioni della guida all'installazione della libreria client Node.js per aggiungere una dipendenza alla libreria client @google-ads/datamanager nel tuo progetto.

(Facoltativo) Ottieni la libreria di utilità e gli esempi di codice.

1. Clona il repository GitHub.

   git clone https://github.com/googleads/data-manager-node.git
   

2. Vai alla directory data-manager-node.

3. Esegui questo comando per installare le dipendenze.

   npm install
   

4. Passa alla directory util.

   cd util
   

5. Esegui questo comando per compilare e comprimere la libreria di utilità in un file .tgz da utilizzare con npm.

   npm pack
   

   Il comando genera un archivio denominato google-ads-datamanager-util-0.2.0.tgz. Prendi nota della posizione del file in modo da poterlo utilizzare nei passaggi successivi.

6. Nel tuo progetto Node.js, dichiara una dipendenza dalla libreria di utilità dell'API Data Manager aggiungendo una voce dependencies per il percorso completo e il nome file del file google-ads-datamanager-util-0.2.0.tgz.

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
         ...
      }
   }
   

   Per formattare i dati, utilizza l'utilità UserDataFormatter nel tuo progetto Node.js.

7. Sfoglia gli esempi di codice nella sottodirectory samples o su GitHub. Esegui gli esempi seguendo questa procedura:

   1. Vai alla directory data-manager-node.

   2. Esegui gli esempi, passando gli argomenti richiesti. Passa l'argomento --help quando esegui un esempio per stampare una dichiarazione di utilizzo con i parametri previsti.

      Ad esempio, il seguente comando esegue l'esempio ingest_audience_members e stampa un'istruzione di utilizzo:

      npm run ingest-audience-members -w samples -- --help
      

   Per iniziare con alcuni dati di esempio, utilizza il file all'indirizzo samples/sampledata/audience_members_1.csv.

PHP

Installa la libreria client

Segui le istruzioni nella guida all'installazione della libreria client PHP per aggiungere una dipendenza alla libreria client googleads/data-manager nel tuo progetto.

(Facoltativo) Ottieni la libreria di utilità e gli esempi di codice.

1. Clona il repository GitHub.

   git clone https://github.com/googleads/data-manager-php.git
   

2. Vai alla directory data-manager-php.

3. Esegui questo comando per risolvere le dipendenze della libreria:

   composer update --prefer-dist
   

4. Nel file composer.json del progetto PHP sullo stesso host, dichiara una dipendenza dalla libreria di utilità seguendo questi passaggi:

   1. Aggiungi una voce nella sezione repositories che rimandi alla posizione della directory data-manager-php.

      "repositories" : [
         {
            "type" : "path",
            "url" : "PATH_TO_UTILITY_LIBRARY"
         }
      ]
      

   2. Dichiara una dipendenza dalla libreria di utilità.

      "require": {
         "googleads/data-manager-util": "@dev"
      }
      

   Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto PHP.

5. Sfoglia gli esempi di codice nella sottodirectory samples o su GitHub. Esegui gli esempi seguendo questa procedura:

   1. Vai alla directory samples.

   2. Esegui questo comando per risolvere le dipendenze della libreria:

      composer update --prefer-dist
      

   3. Esegui gli esempi, passando gli argomenti richiesti. Passa l'argomento --help quando esegui un esempio per stampare una dichiarazione di utilizzo con i parametri previsti.

   Per iniziare con alcuni dati di esempio, utilizza il file all'indirizzo samples/sampledata/audience_members_1.csv.

Python

Installa la libreria client

Segui le istruzioni della guida all'installazione della libreria client Python per aggiungere una dipendenza alla libreria client google-ads-datamanager nel tuo progetto.

(Facoltativo) Ottieni la libreria di utilità e gli esempi di codice.

1. Clona il repository GitHub.

   git clone https://github.com/googleads/data-manager-python.git
   

2. Vai alla directory data-manager-python.

3. Per installare la libreria di utilità nel tuo ambiente Python, esegui questo comando:

   pip install .
   

4. Nel tuo progetto Python, dichiara una dipendenza dalla libreria di utilità. Ad esempio, se utilizzi un file requirements.txt nel tuo progetto, aggiungi la seguente riga al file:

   google-ads-data-manager-util=0.2.0
   

5. Per formattare e criptare i dati, utilizza le utilità Formatter e Encrypter nel tuo progetto Python.

6. Sfoglia gli esempi di codice nella sottodirectory samples o su GitHub. Per eseguire gli esempi, installa le dipendenze necessarie:

   pip install .[samples]
   

   Passa l'argomento --help quando esegui un esempio per stampare un'istruzione di utilizzo con i parametri previsti.

   Per iniziare con alcuni dati di esempio, utilizza il file all'indirizzo samples/sampledata/audience_members_1.csv.

Ruby

Installa la libreria client

Segui le istruzioni nella guida all'installazione della libreria client Ruby per aggiungere una dipendenza alla libreria client nel tuo progetto.

Passaggi successivi

• Scopri di più sull'invio dei dati sul pubblico.
• Scopri di più sull'invio di eventi.
• Sfoglia la documentazione di riferimento REST o RPC.

Suggerimento: per provare un metodo, visita la Guida di riferimento REST e fai clic sul pulsante API nella barra degli strumenti della pagina del metodo. Scopri di più su Visualizzare Explorer API ed eseguire un metodo.