- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CreateUserLinkRequest
- ลองใช้งาน
สร้างข้อมูลเกี่ยวกับการลิงก์ของผู้ใช้หลายรายไปยังบัญชีหรือพร็อพเพอร์ตี้
วิธีการนี้คือธุรกรรม หากสร้าง UserLink ไม่ได้ ก็จะไม่มีการสร้างลิงก์ผู้ใช้
คำขอ HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ บัญชีหรือพร็อพเพอร์ตี้ที่เป็นลิงก์สำหรับผู้ใช้ทั้งหมดในคำขอ ต้องระบุฟิลด์นี้ ช่องระดับบนสุดในข้อความ CreateUserLinkRequest ต้องว่างเปล่าหรือตรงกับช่องนี้ รูปแบบตัวอย่าง: accounts/1234 |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
ช่อง | |
---|---|
notifyNewUsers |
ไม่บังคับ หากตั้งค่าแล้ว ให้ส่งอีเมลถึงผู้ใช้ใหม่เพื่อแจ้งให้ทราบว่าตนได้รับสิทธิ์ในทรัพยากรแล้ว ไม่ว่าจะมีการตั้งค่านี้หรือไม่ก็ตาม ระบบจะไม่สนใจช่อง alertNewUser ภายในแต่ละคำขอ |
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 |
ต้องระบุ ลิงก์ของผู้ใช้ที่จะสร้าง |