The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

Эта страница переведена с помощью Cloud Translation API.

Настройте доступ к API

Вот как настроить доступ к API Data Manager с помощью SDK или REST.

Настройте интерфейс командной строки Google Cloud

Установите и инициализируйте интерфейс командной строки Google Cloud.
Чтобы убедиться, что ваши компоненты gcloud обновлены, выполните следующую команду.
```
gcloud components update
```
(Необязательно) Используйте команду gcloud config set , чтобы задать проект и регион по умолчанию.

Настроить аутентификацию

Вы можете выполнить аутентификацию с помощью учетных записей пользователей и учетных записей служб :

Учетные записи пользователей : представляют людей, которые напрямую взаимодействуют с API и службами Google.
Учетные записи служб : представляют приложения, а не людей, как пользователей. Они позволяют вашим приложениям управлять аутентификацией и авторизацией. Например, если приложению требуется доступ к ресурсам Google Cloud.

Ваша интеграция может использовать Application Default Credentials (ADC) для автоматического поиска учетных данных из среды. Вам не нужно менять клиентский код для аутентификации.

Выберите учетную запись пользователя или учетную запись службы для настройки ADC:

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

Настройте доступ к операционному счету

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

Настройте SDK для вашего языка программирования

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

ОТДЫХ

Обновите заполнители в следующем примере, такие как OPERATING_ACCOUNT_PRODUCT , OPERATING_ACCOUNT_ID и AUDIENCE_ID , значениями для вашей учетной записи и назначения.
Замените PROJECT_ID на идентификатор вашего Google Cloud.

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

Удалите атрибут linkedAccount записи в destinations если вы не получаете доступ к operationAccount с помощью установленной ссылки на продукт.

#!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- &lt;&lt;EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "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

Ява

Загрузите и распакуйте google-cloud-ads-datamanager-v1-java.tar.gz .
Перейдите в каталог google-cloud-ads-datamanager-v1-java .
Выполните следующую команду, чтобы собрать и опубликовать библиотеку в локальном репозитории Maven для использования с Maven или Gradle.
```
./gradlew -Pversion=0.1.0 install
```

В вашем проекте Java объявите зависимость от библиотеки API Data Manager.

Градл:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.0'

Мейвен:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.0</version>
</dependency>

Необязательно . Получите библиотеку утилит и примеры кода.
1. Загрузите и распакуйте data-manager-java.tar.gz .
2. Перейдите в каталог data-manager-java .
3. Для Maven или Gradle выполните следующую команду. Эта команда создает и публикует библиотеку утилит в вашем локальном репозитории Maven.
```
./gradlew data-manager-util:install
```
4. В вашем проекте Java объявите зависимость от библиотеки утилит.
  Градл:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  Мейвен:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. Для форматирования и шифрования данных используйте утилиты UserDataFormatter и Encrypter в вашем проекте Java.
6. Просмотрите примеры кода в подкаталоге data-manager-samples . Чтобы запустить образец из командной строки, используйте задачу Gradle run .
  Например, следующая команда запускает образец IngestAudienceMembers и выводит отчет об использовании:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  Чтобы начать работу с образцами данных, используйте файл data-manager-samples/src/main/resources/sampledata/audience_members_1.csv .

Питон

Загрузитеads -datamanager-v1-py.tar.gz .
Перейдите в каталог загрузки.
Выполните следующую команду, чтобы собрать библиотеку и сделать ее доступной для других проектов в той же среде Python:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
В вашем проекте Python объявите зависимость от библиотеки API Data Manager. Например, если вы используете файл requirements.txt в вашем проекте, добавьте в файл следующую строку:
```
google-ads-data-manager=0.1.0
```
Необязательно . Получите библиотеку утилит и примеры кода.
1. Загрузите и распакуйте data-manager-python.tar.gz .
2. Перейдите в каталог data-manager-python .
3. Чтобы установить библиотеку утилит в вашей среде Python, выполните следующую команду:
```
pip install .
```
4. В вашем проекте Python объявите зависимость от библиотеки утилит. Например, если вы используете файл requirements.txt в вашем проекте, добавьте в файл следующую строку:
```
google-ads-data-manager-util=0.1.0
```
5. Для форматирования и шифрования данных используйте утилиты Formatter и Encrypter в вашем проекте Python.
6. Просмотрите примеры кода в подкаталоге samples . Передайте аргумент --help при запуске примера, чтобы напечатать инструкцию по использованию с ожидаемыми параметрами.
  Чтобы начать работу с образцами данных, используйте файл samples/sampledata/audience_members_1.csv .

Node.js

Загрузите и распакуйте ads-datamanager-v1-nodejs.tar.gz .
Перейдите в каталог ads-datamanager-v1-nodejs .
Выполните следующие команды, чтобы скомпилировать и упаковать библиотеку в файл .tgz для использования с npm .
```
npm install
npm pack
```
Команды создают архив с именем google-cloud-datamanager-0.1.0.tgz .
В проекте Node.js объявите зависимость от библиотеки API Data Manager, добавив запись dependencies для полного пути и имени файла google-cloud-datamanager-0.1.0.tgz .

PHP

Загрузите и распакуйте google-cloud-ads-datamanager-v1-php.tar.gz .
Перейдите в каталог google-cloud-ads-datamanager-v1-php .
Выполните следующую команду, чтобы разрешить зависимости для библиотеки:
```
composer update --prefer-dist
```
В файле composer.json вашего PHP-проекта на том же хосте объявите зависимость от библиотеки API Data Manager, выполнив следующие шаги:
а. Добавьте раздел repositories , указывающий на расположение каталога google-cloud-ads-datamanager-v1-php .
```
 "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]
```
б) Объявите зависимость от библиотеки API Data Manager.
```
 "require": {
    "googleads/data-manager": "^0.1.0"
 }
```