Method: accounts.userLinks.batchCreate

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إنشاء معلومات حول مستخدمين متعددين&#39: روابط إلى حساب أو موقع

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

طلب 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

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

requests[]

object (CreateUserLinkRequest)

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

نص الاستجابة

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

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

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

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

إنشاء طلب ربط مستخدم

رِسَالَة لطَلَبْ CreateUserLink RPC.

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

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

string

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

notifyNewUser

boolean

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