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

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 खाते के क्रेडेंशियल के ऐक्सेस पाथ को तय किया जा सकता है. PartnerLinkService तरीकों के लिए, linked-account हेडर काम नहीं करता.

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

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

किसी पार्टनर के लिंक वापस पाने के लिए, अनुरोध के 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 फ़ील्ड शामिल नहीं है, तो इसका मतलब है कि अब कोई और नतीजा नहीं है.