Method: audienceMembers.ingest

Загружает список ресурсов AudienceMember в указанное Destination .

HTTP-запрос

POST https://datamanager.googleapis.com/v1/audienceMembers:ingest

URL-адрес использует синтаксис gRPC Transcoding .

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Поля
destinations[]

object ( Destination )

Обязательно. Список пунктов назначения для отправки участников аудитории.

audienceMembers[]

object ( AudienceMember )

Обязательно. Список пользователей для отправки по указанным адресатам. В одном запросе можно отправить не более 10000 ресурсов AudienceMember .

consent

object ( Consent )

Необязательно. Согласие на уровне запроса применяется ко всем пользователям в запросе. Согласие на уровне пользователя переопределяет согласие на уровне запроса и может быть указано в каждом AudienceMember .

validateOnly

boolean

Необязательно. Для целей тестирования. Если true , запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты.

encoding

enum ( Encoding )

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

encryptionInfo

object ( EncryptionInfo )

Необязательно. Информация о шифровании для загрузок UserData . Если не установлено, предполагается, что загруженная идентификационная информация хешируется, но не шифруется. Для загрузок, не относящихся UserData , это поле игнорируется.

termsOfService

object ( TermsOfService )

Необязательно. Условия обслуживания, которые пользователь принял/отклонил.

Тело ответа

Ответ от IngestAudienceMembersRequest .

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "requestId": string
}
Поля
requestId

string

Автоматически сгенерированный идентификатор запроса.

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/datamanager

Условия обслуживания

Условия обслуживания, которые пользователь принял/отклонил.

JSON-представление 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Поля
customerMatchTermsOfServiceStatus

enum ( TermsOfServiceStatus )

Необязательно. Условия обслуживания Customer Match: https://support.google.com/adspolicy/answer/6299717 . Это необходимо принять для всех загрузок в списки пользователей Customer Match.

Условия обслуживанияСтатус

Представляет собой решение звонящего принять или отклонить условия обслуживания.

Перечисления
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Не указан.
ACCEPTED Статус, указывающий на то, что звонящий принял условия обслуживания.
REJECTED Статус, указывающий на то, что звонящий решил отклонить условия обслуживания.