Method: accounts.userLinks.batchCreate

इस जानकारी का इस्तेमाल करके, कई उपयोगकर्ताओं को किसी खाते या प्रॉपर्टी से लिंक किया जाता है.

यह तरीका लेन-देन से जुड़ा है. अगर कोई UserLink नहीं बनाया जा सकता, तो कोई भी UserLinks नहीं बनाया जाएगा.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह खाता या प्रॉपर्टी जिसके लिए सभी उपयोगकर्ताओं ने अनुरोध किया है. यह फ़ील्ड भरना ज़रूरी है. CreateUserLinkRequest मैसेज का पैरंट फ़ील्ड या तो खाली होना चाहिए या इस फ़ील्ड से मेल खाना चाहिए. उदाहरण के लिए: accounts/1234

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
फ़ील्ड
notifyNewUsers

boolean

ज़रूरी नहीं. अगर नीति को सेट किया जाता है, तो नए उपयोगकर्ताओं को ईमेल भेजकर बताएं कि उन्हें संसाधन की अनुमतियां दी गई हैं. इस बात से कोई फ़र्क़ नहीं पड़ता कि इसे सेट किया गया है या नहीं, हर अलग अनुरोध में मौजूद NotificationNewUser फ़ील्ड को अनदेखा कर दिया जाता है.
requests[]

object (CreateUserLinkRequest)

ज़रूरी है. ये ऐसे अनुरोध होते हैं जिनमें उपयोगकर्ता के लिंक बनाने के लिए कहा जाता है. एक बैच में ज़्यादा से ज़्यादा 1,000 उपयोगकर्ता लिंक बनाए जा सकते हैं.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में BatchCreateUserLinksResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

CreateUserLinkRequest

userLinks.create RPC के लिए अनुरोध मैसेज.

उपयोगकर्ताओं के पास उनके Google खाते से जुड़े एक से ज़्यादा ईमेल पते हो सकते हैं और इनमें से एक ईमेल पता "मुख्य" ईमेल पता होता है. Google खाते से जुड़े किसी भी ईमेल पते का इस्तेमाल नए UserLink के लिए किया जा सकता है. हालांकि, UserLink से मिलने वाले ईमेल में हमेशा "मुख्य" ईमेल पता शामिल होगा. इस वजह से, इस अनुरोध के इनपुट और आउटपुट ईमेल पते में अंतर हो सकता है.

जेएसओएन के काेड में दिखाना 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
फ़ील्ड
parent

string

ज़रूरी है. उदाहरण के लिए: accounts/1234
notifyNewUser

boolean

ज़रूरी नहीं. अगर नीति को सेट किया जाता है, तो नए उपयोगकर्ता को यह सूचना देते हुए ईमेल भेजें कि उन्हें संसाधन की अनुमतियां दे दी गई हैं.