Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Installare 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).

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 per il tuo account e la tua 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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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.

Clona il repository GitHub.

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

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" />
```
Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto .NET.
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 a utilizzare alcuni dati di esempio, utilizza i file all'indirizzo samples/sampledata.

Go

Installa la libreria client

go get cloud.google.com/go/datamanager/apiv1@latest

Per saperne di più, segui le istruzioni riportate nella guida alla libreria client Go.

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) Installa la libreria di utilità

Oltre alla libreria client, puoi installare la libreria di utilità per facilitare le attività comuni come la formattazione e la crittografia dei dati per l'importazione.

Nel tuo progetto Java, dichiara una dipendenza dalla libreria di utilità data-manager-util.

Gradle:

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

Maven:

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

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

Sfoglia esempi di codice

Sfoglia gli esempi di codice nella sottodirectory data-manager-samples o su GitHub.

Per eseguire gli esempi:

Clona il repository GitHub al tag v0.4.0:

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

Vai alla directory data-manager-java.
Esegui gli esempi dalla riga di comando utilizzando l'attività Gradle run, passando gli argomenti richiesti. Passa l'argomento --help quando esegui un campione per stampare un'istruzione di utilizzo con i parametri previsti.

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 i file all'indirizzo data-manager-samples/src/main/resources/sampledata.

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) Installa la libreria di utilità

Oltre alla libreria client, puoi installare la libreria di utilità per facilitare le attività comuni come la formattazione dei dati per l'importazione.

Nel tuo progetto Node.js, dichiara una dipendenza dalla libreria di utilità @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Per formattare i dati, utilizza l'utilità UserDataFormatter nel tuo progetto Node.js.

Sfoglia esempi di codice

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

Per eseguire gli esempi:

Clona il repository GitHub al tag v0.4.1:

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

Vai alla directory data-manager-node.
Installa le dipendenze per l'esecuzione degli esempi:
```
npm install
```
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 i file all'indirizzo samples/sampledata.

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) Installa la libreria di utilità

Oltre alla libreria client, puoi installare la libreria di utilità per facilitare le attività comuni come la formattazione dei dati per l'importazione.

Nel file composer.json del tuo progetto PHP sullo stesso host, dichiara una dipendenza dalla libreria di utilità:
```
composer require googleads/data-manager-util
```
Per formattare i dati, utilizza l'utilità Formatter nel tuo progetto PHP.

Sfoglia esempi di codice

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

Per eseguire gli esempi:

Clona il repository GitHub al tag v0.4.0:

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

Vai alla directory data-manager-php/samples.
Installa le dipendenze per l'esecuzione degli esempi:
```
composer install
```
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:
```
php audiences/ingest_audience_members.php --help
```

Per iniziare a utilizzare alcuni dati di esempio, utilizza i file all'indirizzo samples/sampledata.

Python

Installa la libreria client

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

(Facoltativo) Installa la libreria di utilità

Oltre alla libreria client, puoi installare la libreria di utilità per facilitare le attività comuni come la formattazione e la crittografia dei dati per l'importazione.

Nel tuo progetto Python, dichiara una dipendenza dalla libreria di utilità google-ads-datamanager-util.

Ad esempio, se utilizzi un file requirements.txt nel tuo progetto, aggiungi la seguente riga al file:
```
google-ads-datamanager-util==0.4.0
```
In alternativa, installa direttamente la libreria di utilità:
```
pip install google-ads-datamanager-util==0.4.0
```
Per formattare e criptare i dati, utilizza le utilità Formatter e Encrypter nel tuo progetto Python.

Sfoglia esempi di codice

Clona il repository GitHub al tag v0.4.0:

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

Vai alla directory data-manager-python.
Installa le dipendenze per l'esecuzione degli esempi:
```
pip install -r samples/requirements.txt
```
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:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Per iniziare a utilizzare alcuni dati di esempio, utilizza i file all'indirizzo samples/sampledata.

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.

Indietro

Configurare l'accesso API

Avanti

Skill dell'agente

Installare 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) Ottieni la libreria di utilità e gli esempi di codice.

Go

Installa la libreria client

Java

Installa la libreria client

(Facoltativo) Installa la libreria di utilità

Sfoglia esempi di codice

Node.js

Installa la libreria client

(Facoltativo) Installa la libreria di utilità

Sfoglia esempi di codice

PHP

Installa la libreria client

(Facoltativo) Installa la libreria di utilità

Sfoglia esempi di codice

Python

Installa la libreria client

(Facoltativo) Installa la libreria di utilità

Sfoglia esempi di codice

Ruby

Installa la libreria client

Passaggi successivi

Installare una libreria client