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 alle API, inclusa la configurazione delle credenziali predefinite dell'applicazione (ADC).

Passaggi di installazione

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

REST

Aggiorna i segnaposto nel seguente esempio, ad esempio OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, e AUDIENCE_ID, con i valori del tuo account e della destinazione.
Sostituisci PROJECT_ID con l'ID del tuo Google Cloud.

Copia l'esempio nella riga di comando per inviare la richiesta. Utilizza l'esempio Partner di dati solo se accedi all'account operativo tramite un link partner. In caso contrario, utilizza l'esempio Inserzionista.

Inserzionista

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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

Partner di dati

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "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

.NET

Installa la libreria client

Segui le istruzioni nella .NET client library installation guide per aggiungere una dipendenza alla libreria client nel tuo project.

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

Clona il repository GitHub.

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

Nel tuo progetto .NET, dichiara una dipendenza ProjectReference nella 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" />
```
Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto .NET.
Sfoglia gli esempi di codice nella samples sottodirectory o su GitHub.

Passa alla directory samples e utilizza dotnet run per visualizzare l'elenco degli esempi 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 a utilizzare alcuni dati di esempio, utilizza il file in samples/sampledata/audience_members_1.csv.

Java

Installa la libreria client

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

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

Clona il repository GitHub.

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

Vai alla directory data-manager-java.
Crea e pubblica la libreria di utilità nel repository Maven locale.
```
./gradlew data-manager-util:install
```

Nel tuo progetto Java, dichiara una dipendenza nella 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>

Per formattare e criptare i dati, utilizza le utilità UserDataFormatter e Encrypter nel tuo progetto Java.
Sfoglia gli esempi di codice nella data-manager-samples sottodirectory o su GitHub. Per eseguire un esempio dalla riga di comando, utilizza l'attività run di Gradle.

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 a utilizzare alcuni dati di esempio, utilizza il file in data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

Installa la libreria client

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

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

Clona il repository GitHub.

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

Vai alla directory data-manager-node.
Esegui il comando seguente per installare le dipendenze.
```
npm install
```
Passa alla directory util.
```
cd util
```
Esegui il comando seguente 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.
Nel tuo progetto Node.js, dichiara una dipendenza nella 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.
Sfoglia gli esempi di codice nella samples sottodirectory 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 un'istruzione 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 a utilizzare alcuni dati di esempio, utilizza il file in 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) Scarica la libreria di utilità e gli esempi di codice.

Clona il repository GitHub.

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

Vai alla directory data-manager-php.
Esegui il comando seguente per risolvere le dipendenze della libreria:
```
composer update --prefer-dist
```
Nel file composer.json del tuo progetto PHP sullo stesso host, dichiara una dipendenza nella libreria di utilità seguendo questa procedura:
1. Aggiungi una voce nella sezione repositories che rimanda alla posizione della directory data-manager-php.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
2. Dichiara una dipendenza nella libreria di utilità.
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto PHP.
Sfoglia gli esempi di codice nella samples sottodirectory o su GitHub. Esegui gli esempi seguendo questa procedura:
1. Vai alla directory samples.
2. Esegui il comando seguente 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 un'istruzione di utilizzo con i parametri previsti.
Per iniziare a utilizzare alcuni dati di esempio, utilizza il file in samples/sampledata/audience_members_1.csv.

Python

Installa la libreria client

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

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

Clona il repository GitHub.

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

Vai alla directory data-manager-python.
Per installare la libreria di utilità nel tuo ambiente Python, esegui il comando seguente:
```
pip install .
```
Nel tuo progetto Python, dichiara una dipendenza nella libreria di utilità. Ad esempio, se utilizzi un file requirements.txt nel tuo progetto, aggiungi la seguente riga al file:
```
google-ads-datamanager-util=0.2.0
```
Per formattare e criptare i dati, utilizza le utilità Formatter e Encrypter nel tuo progetto Python.
Sfoglia gli esempi di codice nella samples sottodirectory 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 a utilizzare alcuni dati di esempio, utilizza il file in 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 degli eventi.
Sfoglia la documentazione di riferimento REST o RPC.

Indietro

Configurare l'accesso API

Installa una libreria client Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prerequisiti

Passaggi di installazione

REST

Inserzionista

Partner di dati

.NET

Installa la libreria client

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

Java

Installa la libreria client

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

Node.js

Installa la libreria client

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

PHP

Installa la libreria client

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

Python

Installa la libreria client

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

Ruby

Installa la libreria client

Passaggi successivi

Installa una libreria client