पार्टनर के लिंक वापस पाना

SearchPartnerLinksRequest भेजकर, PartnerLink संसाधन वापस पाएं.

अनुरोध में parent फ़ील्ड भरना ज़रूरी है. parent को किसी खाते के संसाधन के नाम पर सेट करें. इसके लिए, इस फ़ॉर्मैट का इस्तेमाल करें:

accountTypes/{account_type}/accounts/{account}

अलग-अलग इस्तेमाल के उदाहरणों में आसानी से इस्तेमाल करने के लिए, SearchPartnerLinksResponse में वे सभी PartnerLink संसाधन शामिल होते हैं जहां अनुरोध में parent इनमें से कोई एक होता है:

• owner_account फ़ील्ड से पहचाना गया खाता
• partner_account फ़ील्ड से पहचाना गया खाता

अगर parent खाते को ऐक्सेस करने के लिए, पार्टनर लिंक, पैरंट Google Ads मैनेजर खाते या पैरंट Display & Video 360 पार्टनर खाते का इस्तेमाल किया जा रहा है, तो अनुरोध के हेडर सेट करें.

नतीजों को फ़िल्टर करना, ताकि जवाब में सिर्फ़ खास एट्रिब्यूट वाले संसाधन शामिल हों.

Search वाला तरीका, नतीजों के पेज दिखाता है. किसी अनुरोध के लिए सभी संसाधन वापस पाने के लिए, next_page_token देखें और नतीजों को पेज के हिसाब से बांटें.

अनुरोध के हेडर सेट करना

Search तरीका, login-account हेडर के साथ काम करता है. इससे अनुरोध में, parent खाते के लिए आपके क्रेडेंशियल के ऐक्सेस पाथ को तय किया जा सकता है. linked-account हेडर, PartnerLinkService तरीकों के लिए काम नहीं करता.

ऐक्सेस करने के अलग-अलग मामलों के लिए हेडर सेट करने के तरीके के बारे में ज़्यादा जानकारी और निर्देश पाने के लिए, डेस्टिनेशन और हेडर देखें.

फ़िल्टर के नतीजे

किसी खास पार्टनर लिंक को वापस पाने के लिए, अनुरोध के filter फ़ील्ड का इस्तेमाल करें. filter फ़ील्ड एक स्ट्रिंग है. इससे उन शर्तों के सेट के बारे में पता चलता है जिन्हें आपको लागू करना है. साथ ही, यह भी पता चलता है कि एपीआई को AND या OR का इस्तेमाल करके शर्तों को जोड़ना चाहिए या नहीं. फ़िल्टर करने के विकल्पों और सिंटैक्स के बारे में ज़्यादा जानने के लिए, AIP-160: फ़िल्टर करना लेख पढ़ें.

filter को मालिकाना हक वाले खाते या पार्टनर खाते के account_id का इस्तेमाल करके तय किया जा सकता है:

• owning_account.account_id: मालिकाना हक वाले खाते का account_id.
• partner_account.account_id: पार्टनर खाते का account_id.

उदाहरण के लिए, यहां एक filter है, जो उन सभी पार्टनर लिंक को दिखाता है जिनके मालिक के खाते का आईडी OWNING_ACCOUNT_ID है:

owning_account.account_id = OWNING_ACCOUNT_ID

यहां filter का एक और उदाहरण दिया गया है. इससे वे सभी पार्टनर लिंक दिखते हैं जिनमें मालिकाना हक वाले खाते का आईडी OWNING_ACCOUNT_ID या पार्टनर खाते का आईडी PARTNER_ACCOUNT_ID है:

owning_account.account_id = OWNING_ACCOUNT_ID OR partner_account.account_id = PARTNER_ACCOUNT_ID

OR के बजाय AND का इस्तेमाल करने के लिए, filter में बदलाव करने पर, नतीजे के तौर पर मिलने वाले संसाधनों को पार्टनर लिंक तक सीमित कर दिया जाता है. इसमें, मालिकाना हक वाले खाते का खाता आईडी OWNING_ACCOUNT_ID और पार्टनर खाते का खाता आईडी PARTNER_ACCOUNT_ID, दोनों शामिल होते हैं:

owning_account.account_id = OWNING_ACCOUNT_ID AND partner_account.account_id = PARTNER_ACCOUNT_ID

नतीजों को पेज के हिसाब से बांटना

एक जवाब में मिलने वाले नतीजों की संख्या को कंट्रोल करने के लिए, page_size फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, अगर page_size को 10 पर सेट किया जाता है, तो एपीआई हर जवाब में ज़्यादा से ज़्यादा 10 नतीजे दिखाएगा. अगर आपके अनुरोध से मैच होने वाले नतीजों की संख्या 10 से कम है, तो हो सकता है कि एपीआई 10 से कम नतीजे दिखाए.

डिफ़ॉल्ट page_size 50 है और ज़्यादा से ज़्यादा 1,000 है.

अगर नतीजे इतने ज़्यादा हैं कि उन्हें एक जवाब में शामिल नहीं किया जा सकता, तो जवाब में next_page_token शामिल किया जाएगा. अगला पेज या नतीजों का सेट पाने के लिए, page_token फ़ील्ड को इस वैल्यू पर सेट करके, वही अनुरोध फिर से भेजें. अन्य सभी पैरामीटर, पिछले अनुरोध के पैरामीटर जैसे ही होने चाहिए.

अगर जवाब में next_page_token फ़ील्ड शामिल नहीं है, तो इसका मतलब है कि कोई और नतीजा नहीं है.