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

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

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

Предварительные требования

Перед установкой клиентской библиотеки выполните действия, описанные в разделе «Настройка доступа к API» , включая настройку учетных данных приложения по умолчанию (ADC) .

Этапы установки

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

ОТДЫХ

В приведенном ниже примере обновите поля-заполнители, такие как 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 , чтобы добавить зависимость от клиентской библиотеки в ваш проект.

Необязательно: получите библиотеку утилит и примеры кода.

Клонируйте репозиторий GitHub .

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

В вашем проекте .NET объявите зависимость ProjectReference от библиотеки утилит. Замените PATH_TO_UTILITY_LIBRARY на путь, куда вы клонировали репозиторий data-manager-dotnet .
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
Для форматирования данных используйте утилиту Formatter в вашем проекте .NET.
Примеры кода можно найти в подкаталоге samples или на GitHub .
Перейдите в каталог 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'

Мэйвен:

<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 .
Запускайте примеры из командной строки с помощью задачи run Gradle, передавая все необходимые аргументы. При запуске примера передайте аргумент --help , чтобы вывести инструкцию по использованию с ожидаемыми параметрами.
Например, следующая команда запускает пример IngestAudienceMembers и выводит инструкцию по его использованию:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

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

Node.js

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

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

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

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

В вашем проекте 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

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

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

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

В файле 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

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

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

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

В вашем проекте на 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 , чтобы добавить зависимость от клиентской библиотеки в ваш проект.

Следующие шаги

Узнайте больше об отправке данных об аудитории .
Узнайте больше об отправке событий .
Ознакомьтесь с документацией по REST или RPC .

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

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

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

Предварительные требования

Этапы установки

ОТДЫХ

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

Партнер по данным

.СЕТЬ

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

Необязательно: получите библиотеку утилит и примеры кода.

Идти

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

Java

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

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

Просмотрите примеры кода

Node.js

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

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

Просмотрите примеры кода

PHP

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

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

Просмотрите примеры кода

Python

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

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

Просмотрите примеры кода

Руби

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

Следующие шаги

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