Instalar uma biblioteca de cliente

Saiba como instalar e configurar uma biblioteca de cliente ou REST.

Pré-requisitos

Antes de instalar uma biblioteca de cliente, conclua as etapas em Configurar o acesso à API, incluindo a configuração das Credenciais padrão do aplicativo (ADC).

Instalar biblioteca

Na máquina local, instale a biblioteca de cliente de sua escolha:

REST

Escolha o tipo de processo de configuração que você quer seguir:

Atualize os marcadores no exemplo a seguir, como OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID e AUDIENCE_ID, com os valores da sua conta e destino.
Substitua PROJECT_ID pelo ID do Google Cloud.

Copie o exemplo para a linha de comando e envie a solicitação.

#!/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

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente.NET para adicionar uma dependência à biblioteca de cliente no seu projeto.

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Clone o repositório do GitHub.

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

No seu projeto .NET, declare uma dependência ProjectReference na biblioteca de utilitários. Substitua PATH_TO_UTILITY_LIBRARY pelo local em que você clonou o repositório data-manager-dotnet.
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
Para formatar dados, use o utilitário Formatter no seu projeto do .NET.
Procure exemplos de código no subdiretório samples ou no GitHub.

Mude para o diretório samples e use dotnet run para receber a lista de exemplos disponíveis.
```
dotnet run
```
Transmita o argumento --help ao executar uma amostra para imprimir uma instrução de uso com os parâmetros esperados.
```
dotnet run -- ingest-audience-members --help
```
Para começar com alguns dados de amostra, use o arquivo em samples/sampledata/audience_members_1.csv.

Java

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente Java para adicionar uma dependência a ela no seu projeto.

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Clone o repositório do GitHub.

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

Navegue até o diretório data-manager-java.
Crie e publique a biblioteca de utilitários no seu repositório Maven local.
```
./gradlew data-manager-util:install
```

No seu projeto Java, declare uma dependência na biblioteca de utilitários.

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>

Para formatar e criptografar os dados, use os utilitários UserDataFormatter e Encrypter no projeto Java.
Procure exemplos de código no subdiretório data-manager-samples ou no GitHub. Para executar uma amostra na linha de comando, use a tarefa run do Gradle.

Por exemplo, o comando a seguir executa a amostra IngestAudienceMembers e imprime uma declaração de uso:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```
Para começar com alguns dados de amostra, use o arquivo em data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente do Node.js para adicionar uma dependência à biblioteca de cliente @google-ads/datamanager no seu projeto.

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Clone o repositório do GitHub.

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

Navegue até o diretório data-manager-node.
Execute o comando a seguir para instalar as dependências:
```
npm install
```
Altere para o diretório util.
```
cd util
```
Execute o comando a seguir para compilar e empacotar a biblioteca de utilitários em um arquivo .tgz para uso com npm.
```
npm pack
```
O comando gera um arquivo chamado google-ads-datamanager-util-0.2.0.tgz. Anote o local do arquivo para usá-lo nas próximas etapas.
No seu projeto Node.js, declare uma dependência na biblioteca utilitária da API Data Manager adicionando uma entrada dependencies para o caminho completo e o nome do arquivo 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",
      ...
   }
}
```
Para formatar dados, use a utilidade UserDataFormatter no projeto Node.js.
Procure exemplos de código no subdiretório samples ou no GitHub. Siga estas etapas para executar as amostras:
1. Navegue até o diretório data-manager-node.
2. Execute as amostras, transmitindo os argumentos necessários. Transmita o argumento --help ao executar uma amostra para imprimir uma declaração de uso com os parâmetros esperados.
  
  Por exemplo, o comando a seguir executa a amostra ingest_audience_members e imprime uma declaração de uso:
```
npm run ingest-audience-members -w samples -- --help
```
Para começar com alguns dados de amostra, use o arquivo em samples/sampledata/audience_members_1.csv.

PHP

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente PHP para adicionar uma dependência à biblioteca de cliente googleads/data-manager no seu projeto.

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Clone o repositório do GitHub.

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

Navegue até o diretório data-manager-php.
Execute o comando a seguir para resolver as dependências da biblioteca:
```
composer update --prefer-dist
```
No arquivo composer.json do projeto PHP no mesmo host, declare uma dependência na biblioteca de utilitários seguindo estas etapas:
1. Adicione uma entrada na seção repositories que aponta para o local do diretório data-manager-php.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
2. Declare uma dependência na biblioteca de utilitários.
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
Para formatar dados, use a utilidade Formatter no projeto PHP.
Procure exemplos de código no subdiretório samples ou no GitHub. Execute as amostras seguindo estas etapas:
1. Navegue até o diretório samples.
2. Execute o comando a seguir para resolver as dependências da biblioteca:
```
composer update --prefer-dist
```
3. Execute as amostras, transmitindo os argumentos necessários. Transmita o argumento --help ao executar uma amostra para imprimir uma declaração de uso com os parâmetros esperados.
Para começar com alguns dados de amostra, use o arquivo em samples/sampledata/audience_members_1.csv.

Python

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente Python para adicionar uma dependência à biblioteca de cliente google-ads-datamanager no seu projeto.

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Clone o repositório do GitHub.

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

Navegue até o diretório data-manager-python.
Para instalar a biblioteca de utilitários no seu ambiente Python, execute o seguinte comando:
```
pip install .
```
No seu projeto Python, declare uma dependência na biblioteca de utilitários. Por exemplo, se você estiver usando um arquivo requirements.txt no seu projeto, adicione a seguinte linha ao arquivo:
```
google-ads-data-manager-util=0.2.0
```
Para formatar e criptografar os dados, use os utilitários Formatter e Encrypter no seu projeto Python.
Procure exemplos de código no subdiretório samples ou no GitHub. Para executar exemplos, instale as dependências necessárias:
```
pip install .[samples]
```
Transmita o argumento --help ao executar uma amostra para imprimir uma instrução de uso com os parâmetros esperados.

Para começar com alguns dados de amostra, use o arquivo em samples/sampledata/audience_members_1.csv.

Ruby

Instale a biblioteca de cliente

Siga as instruções no guia de instalação da biblioteca de cliente Ruby para adicionar uma dependência à biblioteca de cliente no seu projeto.

Próximas etapas

Saiba mais sobre como enviar dados de público-alvo.
Saiba mais sobre o envio de eventos.
Consulte a documentação de referência REST ou RPC.

Configurar o acesso à API

Instalar uma biblioteca de cliente Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Pré-requisitos

Instalar biblioteca

REST

.NET

Instale a biblioteca de cliente

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Java

Instale a biblioteca de cliente

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Node.js

Instale a biblioteca de cliente

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

PHP

Instale a biblioteca de cliente

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Python

Instale a biblioteca de cliente

Opcional: acesse a biblioteca de utilitários e os exemplos de código.

Ruby

Instale a biblioteca de cliente

Próximas etapas

Instalar uma biblioteca de cliente