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 )

Обязательный параметр. Список пользователей, которым необходимо отправить данные в указанные пункты назначения. В одном запросе можно отправить не более 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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Поля
requestId

string

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

fieldWarnings[]

object ( FieldWarning )

Подробные предупреждения на уровне строк с указанием путей к полям.

Области полномочий

Требуется следующая область действия 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 Статус указывает на то, что звонящий отклонил условия предоставления услуг.