Method: users.ingest

Загружает список пользователей в указанные места назначения. В отличие от audienceMembers.ingest (который добавляет пользователей в конкретные списки аудиторий рекламодателей для таргетинга), users.ingest загружает данные о привязке идентификаторов на уровне учетных записей (например, идентификаторы пользователей, связанные с мобильными идентификаторами) независимо от конкретных сегментов аудитории.

Эта функция доступна только для учетных записей, включенных в список разрешенных.

HTTP-запрос

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

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

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

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

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

object ( Destination )

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

users[]

object ( User )

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

encryptionInfo

object ( EncryptionInfo )

Необязательно. Информация о ключах шифрования, используемых для шифрования данных.

validateOnly

boolean

Необязательный параметр. Если true , запрос проверяется, но не выполняется.

encoding

enum ( Encoding )

Обязательно. Тип кодировки идентификаторов пользователей. Для зашифрованных идентификаторов пользователей это относится только к внешней кодировке.

Ответный текст

Ответ от IngestUsersRequest.

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

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

string

Идентификатор сгенерированного запроса на прием данных.

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

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

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

Пользователь

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

JSON-представление 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Поля
userData

object ( UserData )

Обязательно. Несколько предоставленных пользователем данных, используемых для идентификации пользователя.

mobileData

object ( MobileData )

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