- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- CreateUserLinkRequest
- Cobalah!
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 |
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 ( |
Kolom | |
---|---|
notifyNewUsers |
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[] |
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 ( |
Kolom | |
---|---|
parent |
Wajib. Contoh format: accounts/1234 |
notifyNewUser |
Opsional. Jika ditetapkan, kirim email kepada pengguna baru untuk memberi tahu bahwa ia telah diberi izin ke resource. |
userLink |
Wajib. Tautan pengguna untuk dibuat. |