Method: accountTypes.accounts.partnerLinks.search

यह फ़ंक्शन, किसी खाते से लिंक किए गए सभी पार्टनर खातों को खोजता है.

अनुमति हेडर:

यह तरीका, इन वैकल्पिक हेडर के साथ काम करता है. इनसे यह तय किया जाता है कि एपीआई, अनुरोध के लिए ऐक्सेस की अनुमति कैसे देता है:

  • login-account: (ज़रूरी नहीं) यह उस खाते के संसाधन का नाम है जहां क्रेडेंशियल का Google खाता, उपयोगकर्ता है. अगर यह सेट नहीं किया गया है, तो डिफ़ॉल्ट रूप से अनुरोध करने वाले खाते पर लागू होता है. फ़ॉर्मैट: accountTypes/{loginAccountType}/accounts/{loginAccountId}

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

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/partnerLinks:search

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह खाता जिसमें पार्टनर लिंक खोजने हैं. अगर कोई filter नहीं दिया गया है, तो पार्टनर के वे सभी लिंक दिखाए जाते हैं जिनमें यह खाता, owningAccount या partnerAccount है.

फ़ॉर्मैट: accountTypes/{accountType}/accounts/{account}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

पार्टनर के ज़्यादा से ज़्यादा लिंक वापस लाने की संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 पार्टनर लिंक दिखेंगे. ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. 100 से ज़्यादा वैल्यू को 100 में बदल दिया जाएगा.
pageToken

string

यह एक पेज टोकन है, जो पिछले partnerLinks.search कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से डेटा दिखाने के दौरान, partnerLinks.search को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.
filter

string

ज़रूरी नहीं. फ़िल्टर स्ट्रिंग. सभी फ़ील्ड, हर शर्त के बाईं ओर होने चाहिए. उदाहरण के लिए: partner_link_id = 123456789. फ़ील्ड को सभी कैमल केस या सभी स्नेक केस का इस्तेमाल करके तय किया जाना चाहिए. कैमल केस और स्नेक केस, दोनों का एक साथ इस्तेमाल न करें.

इन कार्रवाइयों के लिए यह सुविधा उपलब्ध है:

  • AND
  • =
  • !=

इन फ़ील्ड के लिए यह सुविधा उपलब्ध है:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

उदाहरण: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

SearchPartnerLinksRequest से मिला जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "partnerLinks": [
    {
      object (PartnerLink)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
nextPageToken

string

यह एक टोकन है. इसका इस्तेमाल pageToken के तौर पर किया जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.

अनुमति पाने के लिंक

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

  • https://www.googleapis.com/auth/datamanager