Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Instala una biblioteca cliente

A continuación, se explica cómo instalar y configurar una biblioteca cliente o REST.

Requisitos previos

Antes de instalar una biblioteca cliente, completa los pasos que se indican en Configura el acceso a la API, incluida la configuración de las credenciales predeterminadas de la aplicación (ADC).

Pasos de instalación

En tu máquina local, instala la biblioteca cliente que elijas:

REST

Actualiza los marcadores de posición en el siguiente ejemplo, como OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID y AUDIENCE_ID, con los valores de tu cuenta y destino.
Reemplaza PROJECT_ID por el ID de tu proyecto de Google Cloud.

Copia la muestra en la línea de comandos para enviar la solicitud. Solo usa la muestra de Socio de datos si accedes a la cuenta operativa a través de un vínculo de socio. De lo contrario, usa el ejemplo de anunciante.

Anunciante

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

Socio de datos

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

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de.NET para agregar una dependencia a la biblioteca cliente en tu proyecto.

Opcional: Obtén la biblioteca de utilidades y las muestras de código.

Clona el repositorio de GitHub.

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

En tu proyecto de .NET, declara una dependencia ProjectReference en la biblioteca de utilidades. Reemplaza PATH_TO_UTILITY_LIBRARY por la ubicación en la que clonaste el repositorio data-manager-dotnet.
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
Para formatear datos, usa la utilidad Formatter en tu proyecto de .NET.
Explora las muestras de código en el subdirectorio samples o en GitHub.

Cambia al directorio samples y usa dotnet run para obtener la lista de muestras disponibles.
```
dotnet run
```
Pasa el argumento --help cuando ejecutes una muestra para imprimir una declaración de uso con los parámetros esperados.
```
dotnet run -- ingest-audience-members --help
```
Para ayudarte a comenzar con algunos datos de muestra, usa los archivos en samples/sampledata.

Go

Instala la biblioteca cliente

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

Para obtener más información, sigue las instrucciones de la guía de la biblioteca cliente de Go.

Java

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de Java para agregar una dependencia a la biblioteca cliente en tu proyecto.

Opcional: Instala la biblioteca de utilidades

Además de la biblioteca cliente, puedes instalar la biblioteca de utilidades para ayudarte con tareas comunes, como el formato y la encriptación de datos para la transferencia.

En tu proyecto de Java, declara una dependencia en la biblioteca de utilidades 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>

Para formatear y encriptar los datos, usa las utilidades UserDataFormatter y Encrypter en tu proyecto de Java.

Explorar muestras de código

Explora las muestras de código en el subdirectorio data-manager-samples o en GitHub.

Para ejecutar las muestras, haz lo siguiente:

Clona el repositorio de GitHub en la etiqueta v0.4.0:

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

Navega al directorio data-manager-java.
Ejecuta las muestras desde la línea de comandos con la tarea run de Gradle y pasa los argumentos necesarios. Pasa el argumento --help cuando ejecutes una muestra para imprimir una declaración de uso con los parámetros esperados.

Por ejemplo, el siguiente comando ejecuta la muestra IngestAudienceMembers y muestra una declaración de uso:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

Para ayudarte a comenzar con algunos datos de muestra, usa los archivos en data-manager-samples/src/main/resources/sampledata.

Node.js

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de Node.js para agregar una dependencia a la biblioteca cliente de @google-ads/datamanager en tu proyecto.

Opcional: Instala la biblioteca de utilidades

Además de la biblioteca cliente, puedes instalar la biblioteca de utilidades para ayudarte con tareas comunes, como el formato de datos para la transferencia.

En tu proyecto de Node.js, declara una dependencia en la biblioteca de utilidades @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Para formatear datos, usa la utilidad UserDataFormatter en tu proyecto de Node.js.

Explorar muestras de código

Explora las muestras de código en el subdirectorio samples o en GitHub.

Para ejecutar las muestras, haz lo siguiente:

Clona el repositorio de GitHub en la etiqueta v0.4.1:

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

Navega al directorio data-manager-node.
Instala las dependencias para ejecutar las muestras:
```
npm install
```
Ejecuta las muestras y pasa los argumentos necesarios. Pasa el argumento --help cuando ejecutes una muestra para imprimir una declaración de uso con los parámetros esperados.

Por ejemplo, el siguiente comando ejecuta la muestra ingest-audience-members y muestra una declaración de uso:
```
npm run ingest-audience-members -w samples -- --help
```

Para ayudarte a comenzar con algunos datos de muestra, usa los archivos en samples/sampledata.

PHP

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de PHP para agregar una dependencia a la biblioteca cliente de googleads/data-manager en tu proyecto.

Opcional: Instala la biblioteca de utilidades

Además de la biblioteca cliente, puedes instalar la biblioteca de utilidades para ayudarte con tareas comunes, como el formato de datos para la transferencia.

En el archivo composer.json de tu proyecto de PHP en el mismo host, declara una dependencia en la biblioteca de utilidades:
```
composer require googleads/data-manager-util
```
Para formatear datos, usa la utilidad Formatter en tu proyecto de PHP.

Explorar muestras de código

Explora las muestras de código en el subdirectorio samples o en GitHub.

Para ejecutar las muestras, haz lo siguiente:

Clona el repositorio de GitHub en la etiqueta v0.4.0:

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

Navega al directorio data-manager-php/samples.
Instala las dependencias para ejecutar las muestras:
```
composer install
```
Ejecuta las muestras y pasa los argumentos necesarios. Pasa el argumento --help cuando ejecutes una muestra para imprimir una declaración de uso con los parámetros esperados.

Por ejemplo, el siguiente comando ejecuta la muestra ingest_audience_members y muestra una declaración de uso:
```
php audiences/ingest_audience_members.php --help
```

Para ayudarte a comenzar con algunos datos de muestra, usa los archivos en samples/sampledata.

Python

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de Python para agregar una dependencia a la biblioteca cliente de google-ads-datamanager en tu proyecto.

Opcional: Instala la biblioteca de utilidades

Además de la biblioteca cliente, puedes instalar la biblioteca de utilidades para ayudarte con tareas comunes, como el formato y la encriptación de datos para la transferencia.

En tu proyecto de Python, declara una dependencia en la biblioteca de utilidades google-ads-datamanager-util.

Por ejemplo, si usas un archivo requirements.txt en tu proyecto, agrega la siguiente línea al archivo:
```
google-ads-datamanager-util==0.4.0
```
O bien, instala la biblioteca de utilidades directamente:
```
pip install google-ads-datamanager-util==0.4.0
```
Para formatear y encriptar los datos, usa las utilidades Formatter y Encrypter en tu proyecto de Python.

Explorar muestras de código

Clona el repositorio de GitHub en la etiqueta v0.4.0:

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

Navega al directorio data-manager-python.
Instala las dependencias para ejecutar las muestras:
```
pip install -r samples/requirements.txt
```
Ejecuta las muestras y pasa los argumentos necesarios. Pasa el argumento --help cuando ejecutes una muestra para imprimir una declaración de uso con los parámetros esperados.

Por ejemplo, el siguiente comando ejecuta la muestra ingest_audience_members y muestra una declaración de uso:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Para ayudarte a comenzar con algunos datos de muestra, usa los archivos en samples/sampledata.

Ruby

Instala la biblioteca cliente

Sigue las instrucciones de la guía de instalación de la biblioteca cliente de Ruby para agregar una dependencia a la biblioteca cliente en tu proyecto.

Próximos pasos

Obtén más información para enviar datos de público.
Obtén más información para enviar eventos.
Consulta la documentación de referencia de REST o RPC.

Configura el acceso a la API

Habilidades del agente

Instala una biblioteca cliente Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Requisitos previos

Pasos de instalación

REST

Anunciante

Socio de datos

.NET

Instala la biblioteca cliente

Opcional: Obtén la biblioteca de utilidades y las muestras de código.

Go

Instala la biblioteca cliente

Java

Instala la biblioteca cliente

Opcional: Instala la biblioteca de utilidades

Explorar muestras de código

Node.js

Instala la biblioteca cliente

Opcional: Instala la biblioteca de utilidades

Explorar muestras de código

PHP

Instala la biblioteca cliente

Opcional: Instala la biblioteca de utilidades

Explorar muestras de código

Python

Instala la biblioteca cliente

Opcional: Instala la biblioteca de utilidades

Explorar muestras de código

Ruby

Instala la biblioteca cliente

Próximos pasos

Instala una biblioteca cliente