Method: customers.uploadUserData

Загружает указанные пользовательские данные.

Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP-запрос

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

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

Параметры пути

Параметры
customerId

string

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

Тело запроса

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

JSON-представление
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Поля
operations[]

object ( UserDataOperation )

Необходимый. Перечень операций, которые необходимо выполнить.

metadata поля объединения. Метаданные запроса. metadata могут быть только одним из следующих:
customerMatchUserListMetadata

object ( CustomerMatchUserListMetadata )

Метаданные для обновления данных списка пользователей электронных адресов.

Тело ответа

Ответное сообщение для UserDataService.UploadUserData Загрузки, выполненные через эту службу, не будут отображаться в разделе «Участники сегмента» списка электронных адресов в пользовательском интерфейсе Google Рекламы.

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

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

string

Дата и время получения запроса API в формате «гггг-мм-дд чч:мм:сс+|-чч:мм», например «2019-01-01 12:32:45-08:00». ".

receivedOperationsCount

integer

Количество операций загрузки данных, полученных API.

Области авторизации

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

ПользовательскиеДанныеОперация

Операция, которую необходимо выполнить для UploadUserDataRequest.

JSON-представление
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Поля
Полевая operation Союза. Операция, которую необходимо выполнить для UploadUserDataRequest. operation может быть только одной из следующих:
create

object ( UserData )

Список пользовательских данных, которые будут добавлены в список пользователей.

remove

object ( UserData )

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