Method: properties.userLinks.batchCreate

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

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

طلب HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/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