Method: accounts.userLinks.batchCreate

تُنشئ معلومات عن روابط المستخدِمين المتعددين بحساب أو موقع.

هذه الطريقة متعلقة بالمعاملات. إذا تعذّر إنشاء أي UserLink، فلن يتم إنشاء أي من روابط UserLink.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. الحساب أو الموقع المُخصّص لجميع روابط المستخدِمين في الطلب. هذا الحقل مطلوب. يجب أن يكون الحقل الرئيسي في رسائل CreateUserLinkRequest فارغًا أو مطابقًا لهذا الحقل. مثال على التنسيق: accounts/1234

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
الحقول
notifyNewUsers

boolean

اختياريّ. في حال تم ضبط السياسة، يتم إرسال رسالة إلكترونية إلى المستخدمين الجدد لإبلاغهم بأنّه تم منحهم أذونات للمورد. وبغض النظر عمّا إذا تم ضبط ذلك أم لا، يتم تجاهل حقل notificationsNewUser داخل كل طلب فردي.
requests[]

object (CreateUserLinkRequest)

مطلوبة. تمثّل هذه السمة الطلبات التي تحدِّد روابط المستخدِم التي يجب إنشاؤها. يمكن إنشاء 1000 رابط مستخدم كحد أقصى في دُفعة واحدة.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال BatchCreateUserLinksResponse.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/analytics.manage.users

CreateUserLinkRequest

طلب رسالة من أجل userLinks.create RPC.

يمكن أن يكون للمستخدمين عدة عناوين بريد إلكتروني مرتبطة بحساباتهم على Google، وأحد عناوين البريد الإلكتروني هذه هو عنوان البريد الإلكتروني "الأساسي". يمكن استخدام أي من عناوين البريد الإلكتروني المرتبطة بحساب Google لإنشاء رابط مستخدم جديد، إلا أن رابط المستخدم الذي تم إرجاعه سيحتوي دائمًا على عنوان البريد الإلكتروني "الأساسي". نتيجةً لذلك، قد يختلف عنوان البريد الإلكتروني للإدخال والإخراج لهذا الطلب.

تمثيل JSON 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
الحقول
parent

string

مطلوبة. مثال على التنسيق: accounts/1234
notifyNewUser

boolean

اختياريّ. في حال تم ضبط السياسة، يتم إرسال رسالة إلكترونية إلى المستخدم الجديد لإعلامه بأنّه تم منحه أذونات للمورد.