- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CreateUserLinkRequest
- ลองใช้งาน
สร้างข้อมูลเกี่ยวกับการลิงก์ของผู้ใช้หลายรายกับบัญชีหรือพร็อพเพอร์ตี้
วิธีนี้เป็นการทำธุรกรรม หากสร้าง UserLink ไม่ได้ จะไม่มีการสร้าง UserLink ใดๆ
คำขอ HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ บัญชีหรือพร็อพเพอร์ตี้ที่ผู้ใช้ทั้งหมดลิงก์ไว้ในคําขอ ต้องระบุฟิลด์นี้ ช่องระดับบนสุดในข้อความ CreateUserLinkRequest ต้องว่างเปล่าหรือตรงกับช่องนี้ รูปแบบตัวอย่าง: accounts/1234 |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
ช่อง | |
---|---|
notifyNewUsers |
ไม่บังคับ หากตั้งค่าแล้ว ให้ส่งอีเมลถึงผู้ใช้ใหม่เพื่อแจ้งให้ทราบว่าผู้ใช้ได้รับสิทธิ์ในการเข้าถึงทรัพยากรแล้ว ไม่ว่าจะตั้งค่าไว้หรือไม่ก็ตาม ระบบจะไม่สนใจช่อง notificationsNewUser ในแต่ละคำขอ |
requests[] |
ต้องระบุ คำขอที่ระบุลิงก์ของผู้ใช้ที่จะสร้าง สร้างลิงก์ผู้ใช้ในกลุ่มได้สูงสุด 1,000 ลิงก์ |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ BatchCreateUserLinksResponse
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/analytics.manage.users
CreateUserLinkRequest
ข้อความคำขอสำหรับ userLinks.create RPC
ผู้ใช้มีอีเมลได้หลายรายการที่เชื่อมโยงกับบัญชี Google และหนึ่งในอีเมลเหล่านี้เป็นอีเมล "หลัก" อาจมีการใช้อีเมลใดก็ตามที่เชื่อมโยงกับบัญชี Google สำหรับ UserLink ใหม่ แต่ UserLink ที่ส่งกลับมานั้นจะมีอีเมล "หลัก" เสมอ ด้วยเหตุนี้ อีเมลอินพุตและเอาต์พุตสำหรับคำขอนี้จึงอาจแตกต่างกัน
การแสดง JSON |
---|
{
"parent": string,
"notifyNewUser": boolean,
"userLink": {
object ( |
ช่อง | |
---|---|
parent |
ต้องระบุ รูปแบบตัวอย่าง: accounts/1234 |
notifyNewUser |
ไม่บังคับ หากตั้งค่าแล้ว ให้ส่งอีเมลถึงผู้ใช้ใหม่เพื่อแจ้งให้ทราบว่าผู้ใช้ได้รับสิทธิ์ในการเข้าถึงทรัพยากรแล้ว |
userLink |
ต้องระบุ ลิงก์ของผู้ใช้ที่จะสร้าง |