Method: accounts.userLinks.batchCreate

Crea información sobre las vinculaciones de varios usuarios a una cuenta o propiedad.

Este método es transaccional. Si no se puede crear algún UserLink, no se creará ninguno.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es la cuenta o propiedad para la que se vinculan todos los usuarios en la solicitud. Este campo es obligatorio. El campo superior de los mensajes de CreateUserLinkRequest debe estar vacío o coincidir con este campo. Formato de ejemplo: cuentas/1234

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Campos
notifyNewUsers

boolean

Opcional. Si se configura, envía un correo electrónico a los usuarios nuevos para notificarles que se les otorgaron permisos para el recurso. Independientemente de si se configura o no, se ignora el campo notificationNewUser dentro de cada solicitud individual.
requests[]

object (CreateUserLinkRequest)

Obligatorio. Son las solicitudes que especifican los vínculos del usuario que se crearán. Se puede crear un máximo de 1,000 vinculaciones de usuarios en un lote.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de BatchCreateUserLinksResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

CreateUserLinkRequest

Mensaje de solicitud para la RPC userLinks.create.

Los usuarios pueden tener varias direcciones de correo electrónico asociadas con su Cuenta de Google, y una de esas direcciones es la "principal". Cualquiera de las direcciones de correo electrónico asociadas con una Cuenta de Google se pueden utilizar para un nuevo UserLink, pero el UserLink que se muestra siempre contendrá la dirección de correo electrónico "principal". Como resultado, las direcciones de correo electrónico de entrada y salida de esta solicitud pueden diferir.

Representación JSON 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Campos
parent

string

Obligatorio. Formato de ejemplo: cuentas/1234
notifyNewUser

boolean

Opcional. Si se configura, envía un correo electrónico al usuario nuevo para notificarle que se le otorgaron permisos para el recurso.