Method: accounts.userLinks.batchCreate

Membuat informasi tentang penautan beberapa pengguna ke akun atau properti.

Metode ini bersifat transaksional. Jika UserLink tidak dapat dibuat, tidak ada UserLink yang akan dibuat.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Akun atau properti yang menjadi tujuan penautan semua pengguna dalam permintaan. Kolom ini wajib diisi. Kolom induk di pesan CreateUserLinkRequest harus kosong atau cocok dengan kolom ini. Contoh format: accounts/1234

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Kolom
notifyNewUsers

boolean

Opsional. Jika ditetapkan, kirim email kepada pengguna baru untuk memberi tahu mereka bahwa mereka telah diberi izin ke resource. Terlepas dari apakah ini ditetapkan atau tidak, kolom alertsNewUser di dalam setiap permintaan akan diabaikan.

requests[]

object (CreateUserLinkRequest)

Wajib. Permintaan yang menentukan penautan pengguna yang akan dibuat. Maksimum 1.000 link pengguna dapat dibuat dalam satu batch.

Isi respons

Jika berhasil, isi respons akan berisi instance BatchCreateUserLinksResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

CreateUserLinkRequest

Pesan permintaan untuk userLinks.create RPC.

Pengguna dapat memiliki beberapa alamat email yang dikaitkan dengan Akun Google mereka, dan salah satu alamat email tersebut adalah alamat email "utama". Setiap alamat email yang terkait dengan akun Google dapat digunakan untuk UserLink baru, tetapi UserLink yang ditampilkan akan selalu berisi alamat email "utama". Oleh karena itu, alamat email input dan output untuk permintaan ini mungkin berbeda.

Representasi JSON
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Kolom
parent

string

Wajib. Contoh format: accounts/1234

notifyNewUser

boolean

Opsional. Jika ditetapkan, kirim email kepada pengguna baru untuk memberi tahu bahwa ia telah diberi izin ke resource.