- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- CreateUserLinkRequest
- آن را امتحان کنید!
اطلاعاتی درباره پیوندهای چند کاربر به یک حساب یا دارایی ایجاد می کند.
این روش تراکنشی است. اگر هیچ لینکی ایجاد نشود، هیچ یک از پیوندهای کاربری ایجاد نخواهد شد.
درخواست HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
parent | ضروری. حساب یا خاصیتی که تمام لینک های کاربر در درخواست برای آن هستند. این فیلد الزامی است. فیلد والد در پیامهای CreateUserLinkRequest باید یا خالی باشد یا با این فیلد مطابقت داشته باشد. فرمت مثال: accounts/1234 |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
زمینه های | |
---|---|
notifyNewUsers | اختیاری. در صورت تنظیم، به کاربران جدید ایمیل بزنید و به آنها اطلاع دهید که مجوزهای منبع را دریافت کرده اند. صرف نظر از اینکه آیا این تنظیم شده است یا نه، قسمت notifyNewUser در داخل هر درخواست فردی نادیده گرفته می شود. |
requests[] | ضروری. درخواست هایی که لینک های کاربر را برای ایجاد مشخص می کنند. حداکثر 1000 پیوند کاربر را می توان در یک دسته ایجاد کرد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از 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 | ضروری. لینک کاربر برای ایجاد. |