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