- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- CreateUserLinkRequest
- Pruébala
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 |
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 ( |
Campos | |
---|---|
notifyNewUsers |
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[] |
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 ( |
Campos | |
---|---|
parent |
Obligatorio. Formato de ejemplo: cuentas/1234 |
notifyNewUser |
Opcional. Si se configura, envía un correo electrónico al usuario nuevo para notificarle que se le otorgaron permisos para el recurso. |
userLink |
Obligatorio. El vínculo de usuario que se creará. |