Method: audienceMembers.ingest

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

HTTP-запрос

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

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

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

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

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 )

Обязательно. Список пользователей для отправки по указанным адресам. В одном запросе можно отправить не более 10 000 ресурсов 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 . Необходимо принять их при загрузке UserData или MobileData . Это поле необязательно для списка пользователей Partner Match.

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

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

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