Method: accounts.userLinks.batchCreate

اطلاعاتی درباره پیوندهای چند کاربر به یک حساب یا دارایی ایجاد می کند.

این روش تراکنشی است. اگر هیچ لینکی ایجاد نشود، هیچ یک از پیوندهای کاربری ایجاد نخواهد شد.

درخواست HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. حساب یا خاصیتی که تمام لینک های کاربر در درخواست برای آن هستند. این فیلد الزامی است. فیلد والد در پیام‌های CreateUserLinkRequest باید یا خالی باشد یا با این فیلد مطابقت داشته باشد. فرمت مثال: accounts/1234

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
زمینه های
notifyNewUsers

boolean

اختیاری. در صورت تنظیم، به کاربران جدید ایمیل بزنید و به آنها اطلاع دهید که مجوزهای منبع را دریافت کرده اند. صرف نظر از اینکه آیا این تنظیم شده است یا نه، قسمت notifyNewUser در داخل هر درخواست فردی نادیده گرفته می شود.

requests[]

object ( CreateUserLinkRequest )

ضروری. درخواست هایی که لینک های کاربر را برای ایجاد مشخص می کنند. حداکثر 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 (UserLink)
  }
}
زمینه های
parent

string

ضروری. فرمت مثال: accounts/1234

notifyNewUser

boolean

اختیاری. در صورت تنظیم، سپس به کاربر جدید ایمیل بزنید و به آنها اطلاع دهید که مجوزهای منبع را دریافت کرده اند.