Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Установка клиентской библиотеки

Ниже описано, как установить и настроить клиентскую библиотеку или REST.

Требования

Прежде чем устанавливать клиентскую библиотеку, выполните инструкции из раздела Как настроить доступ к API, в том числе настройте Application Default Credentials (ADC).

Как установить

Установите на локальном компьютере клиентскую библиотеку по своему выбору:

REST

Замените плейсхолдеры в приведенном ниже примере, например OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID и AUDIENCE_ID, значениями для вашего аккаунта и целевого ресурса.
Замените PROJECT_ID идентификатором Google Cloud.

Скопируйте пример в командную строку, чтобы отправить запрос. Образец партнера по обработке данных следует использовать, только если вы перешли в управляющий аккаунт по партнерской ссылке. В противном случае используйте образец Рекламодатель.

Рекламодатель

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

Партнер по обработке данных

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

Установите клиентскую библиотеку

Чтобы добавить зависимость от клиентской библиотеки в проект, следуйте инструкциям в руководстве по установке клиентской библиотеки.NET.

Необязательно: установите библиотеку утилит

Помимо клиентской библиотеки, вы можете установить библиотеку утилит, которая поможет вам выполнять такие задачи, как форматирование данных для загрузки.

В проекте .NET объявите зависимость от библиотеки утилит Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Чтобы отформатировать данные, используйте утилиту UserDataFormatter в проекте .NET.

Как найти примеры кода

Примеры кода можно найти в подкаталоге samples или на GitHub.

Чтобы запустить примеры:

Клонируйте репозиторий GitHub с тегом v0.4.0:

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

Перейдите в каталог data-manager-dotnet.
Перейдите в каталог samples и используйте команду dotnet run, чтобы получить список доступных образцов.
```
dotnet run
```
При запуске образца передайте аргумент --help, чтобы вывести инструкцию по использованию с ожидаемыми параметрами.
```
dotnet run -- ingest-audience-members --help
```

Чтобы вам было проще начать работу с образцами данных, используйте файлы, доступные по адресу samples/sampledata.

Проложить маршрут

Установите клиентскую библиотеку

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

Подробная информация приведена в руководстве по клиентской библиотеке Go.

Java

Установите клиентскую библиотеку

Чтобы добавить зависимость от клиентской библиотеки в проект, следуйте инструкциям в руководстве по установке клиентской библиотеки Java.

Необязательно: установите библиотеку утилит

Помимо клиентской библиотеки, вы можете установить вспомогательную библиотеку, которая поможет вам выполнять такие распространенные задачи, как форматирование и шифрование данных для загрузки.

В проекте Java объявите зависимость от библиотеки утилит 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>

Чтобы отформатировать и зашифровать данные, используйте утилиты UserDataFormatter и Encrypter в проекте Java.

Как найти примеры кода

Примеры кода можно найти в подкаталоге data-manager-samples или на GitHub.

Чтобы запустить примеры:

Клонируйте репозиторий GitHub с тегом v0.4.0:

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

Перейдите в каталог data-manager-java.
Запустите примеры из командной строки, используя задачу Gradle run, и передайте все необходимые аргументы. При запуске примера передайте аргумент --help, чтобы вывести инструкцию по использованию с ожидаемыми параметрами.

Например, следующая команда запускает пример IngestAudienceMembers и выводит инструкцию по использованию:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

Чтобы вам было проще начать работу с образцами данных, используйте файлы, доступные по адресу data-manager-samples/src/main/resources/sampledata.

Node.js

Установите клиентскую библиотеку

Чтобы добавить зависимость от клиентской библиотеки @google-ads/datamanager в проект, следуйте инструкциям в руководстве по установке клиентской библиотеки Node.js.

Необязательно: установите библиотеку утилит

В проекте Node.js объявите зависимость от библиотеки утилит @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Чтобы отформатировать данные, используйте утилиту UserDataFormatter в проекте Node.js.

Как найти примеры кода

Примеры кода можно найти в подкаталоге samples или на GitHub.

Чтобы запустить примеры:

Клонируйте репозиторий GitHub с тегом v0.4.1:

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

Перейдите в каталог data-manager-node.
Установите зависимости для запуска примеров:
```
npm install
```
Запустите примеры, передав необходимые аргументы. При запуске образца передайте аргумент --help, чтобы вывести инструкцию по использованию с ожидаемыми параметрами.

Например, следующая команда запускает пример ingest-audience-members и выводит инструкцию по использованию:
```
npm run ingest-audience-members -w samples -- --help
```

Чтобы помочь вам начать работу с образцами данных, используйте файлы по адресу samples/sampledata.

PHP

Установите клиентскую библиотеку

Чтобы добавить зависимость для клиентской библиотеки googleads/data-manager в проект, следуйте инструкциям в руководстве по установке клиентской библиотеки PHP.

Необязательно: установите библиотеку утилит

В файле composer.json проекта PHP на том же хосте объявите зависимость от библиотеки утилит:
```
composer require googleads/data-manager-util
```
Чтобы отформатировать данные, используйте утилиту Formatter в проекте PHP.

Как найти примеры кода

Примеры кода можно найти в подкаталоге samples или на GitHub.

Чтобы запустить примеры:

Клонируйте репозиторий GitHub с тегом v0.4.0:

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

Перейдите в каталог data-manager-php/samples.
Установите зависимости для запуска примеров:
```
composer install
```
Запустите примеры, передав необходимые аргументы. При запуске образца передайте аргумент --help, чтобы вывести инструкцию по использованию с ожидаемыми параметрами.

Например, следующая команда запускает пример ingest_audience_members и выводит инструкцию по использованию:
```
php audiences/ingest_audience_members.php --help
```

Чтобы вам было проще начать работу с образцами данных, используйте файлы, доступные по адресу samples/sampledata.

Python

Установите клиентскую библиотеку

Чтобы добавить в проект зависимость от клиентской библиотеки google-ads-datamanager, следуйте инструкциям в руководстве по установке клиентской библиотеки Python.

Необязательно: установите библиотеку утилит

Помимо клиентской библиотеки, вы можете установить библиотеку утилит, которая поможет вам выполнять такие распространенные задачи, как форматирование и шифрование данных для приема.

В проекте Python объявите зависимость от библиотеки утилит google-ads-datamanager-util.

Например, если в проекте используется файл requirements.txt, добавьте в него следующую строку:
```
google-ads-datamanager-util==0.4.0
```
Или установите библиотеку утилит напрямую:
```
pip install google-ads-datamanager-util==0.4.0
```
Чтобы отформатировать и зашифровать данные, используйте утилиты Formatter и Encrypter в проекте Python.

Как найти примеры кода

Клонируйте репозиторий GitHub с тегом v0.4.0:

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

Перейдите в каталог data-manager-python.
Установите зависимости для запуска примеров:
```
pip install -r samples/requirements.txt
```
Запустите примеры, передав необходимые аргументы. При запуске образца передайте аргумент --help, чтобы вывести инструкцию по использованию с ожидаемыми параметрами.

Например, следующая команда запускает пример ingest_audience_members и выводит инструкцию по использованию:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Чтобы вам было проще начать работу с образцами данных, используйте файлы, доступные по адресу samples/sampledata.

Ruby

Установите клиентскую библиотеку

Следуйте инструкциям в руководстве по установке клиентской библиотеки Ruby, чтобы добавить зависимость от клиентской библиотеки в свой проект.

Дальнейшие действия

Подробнее об отправке данных аудитории…
Подробнее об отправке событий…
Подробнее о том, как развернуть интеграцию в рабочей среде…
Ознакомьтесь со справочной документацией по REST или RPC.

Как настроить доступ к API

Навыки агента

Установка клиентской библиотеки Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Требования

Как установить

REST

Рекламодатель

Партнер по обработке данных

.NET

Установите клиентскую библиотеку

Необязательно: установите библиотеку утилит

Как найти примеры кода

Проложить маршрут

Установите клиентскую библиотеку

Java

Установите клиентскую библиотеку

Необязательно: установите библиотеку утилит

Как найти примеры кода

Node.js

Установите клиентскую библиотеку

Необязательно: установите библиотеку утилит

Как найти примеры кода

PHP

Установите клиентскую библиотеку

Необязательно: установите библиотеку утилит

Как найти примеры кода

Python

Установите клиентскую библиотеку

Необязательно: установите библиотеку утилит

Как найти примеры кода

Ruby

Установите клиентскую библиотеку

Дальнейшие действия

Установка клиентской библиотеки