Method: accounts.userLinks.batchCreate

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

Этот метод является транзакционным. Если какую-либо UserLink создать невозможно, ни одна из UserLinks не будет создана.

HTTP-запрос

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate

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

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

Параметры
parent

string

Необходимый. Аккаунт или ресурс, для которого предназначены все ссылки пользователей в запросе. Это поле обязательно к заполнению. Родительское поле в сообщениях CreateUserLinkRequest должно быть либо пустым, либо соответствовать этому полю. Пример формата: счета/1234.

Тело запроса

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

JSON-представление
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Поля
notifyNewUsers

boolean

Необязательный. Если установлено, отправьте новым пользователям электронное письмо с уведомлением о том, что им предоставлены разрешения на доступ к ресурсу. Независимо от того, установлено это или нет, поле notifyNewUser внутри каждого отдельного запроса игнорируется.

requests[]

object ( CreateUserLinkRequest )

Необходимый. Запросы, указывающие пользовательские ссылки для создания. В пакете можно создать максимум 1000 пользовательских ссылок.

Тело ответа

В случае успеха тело ответа содержит экземпляр BatchCreateUserLinksResponse .

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

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

  • https://www.googleapis.com/auth/analytics.manage.users

Создать запрос ссылки пользователя

Сообщение запроса для userLinks.create RPC.

Пользователи могут иметь несколько адресов электронной почты, связанных с их учетной записью Google, и один из этих адресов электронной почты является «основным» адресом электронной почты. Любой из адресов электронной почты, связанных с учетной записью Google, можно использовать для новой UserLink, но возвращаемая UserLink всегда будет содержать «основной» адрес электронной почты. В результате входной и выходной адрес электронной почты для этого запроса могут отличаться.

JSON-представление
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Поля
parent

string

Необходимый. Пример формата: счета/1234.

notifyNewUser

boolean

Необязательный. Если установлено, отправьте новому пользователю электронное письмо с уведомлением о том, что ему предоставлены разрешения на доступ к ресурсу.