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 )

Optional. Must be provided for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non UserData uploads, this field is ignored.

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