Method: accounts.userLinks.batchCreate

Membuat informasi tentang penautan beberapa pengguna ke satu 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 diisi. Akun atau properti yang dituju oleh semua penautan 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 bahwa mereka telah diberi izin ke fasilitas tersebut. Terlepas dari apakah kolom ini disetel atau tidak, beri tahu kolom NewNewUser di dalam setiap permintaan akan diabaikan.
requests[]

object (CreateUserLinkRequest)

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

Isi respons

Jika berhasil, isi respons memuat 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 ini 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". Akibatnya, alamat email input dan output untuk permintaan ini mungkin berbeda.

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

string

Wajib diisi. Contoh format: accounts/1234
notifyNewUser

boolean

Opsional. Jika disetel, kirim email kepada pengguna baru untuk memberi tahu bahwa mereka telah diberi izin ke fasilitas tersebut.