পার্টনার লিঙ্কগুলি পুনরুদ্ধার করুন

একটি SearchPartnerLinksRequest পাঠিয়ে PartnerLink রিসোর্সসমূহ পুনরুদ্ধার করুন।

অনুরোধের parent ফিল্ডটি আবশ্যক। নিম্নলিখিত ফরম্যাট ব্যবহার করে একটি নির্দিষ্ট অ্যাকাউন্টের রিসোর্স নেমকে parent হিসেবে সেট করুন:

accountTypes/{account_type}/accounts/{account}

বিভিন্ন ব্যবহারের ক্ষেত্রে নমনীয়তার জন্য, SearchPartnerLinksResponse সেই সমস্ত PartnerLink রিসোর্স অন্তর্ভুক্ত থাকে, যেখানে অনুরোধের parent হলো নিম্নলিখিতগুলির মধ্যে একটি:

• owner_account ফিল্ড দ্বারা চিহ্নিত অ্যাকাউন্ট
• partner_account ফিল্ড দ্বারা চিহ্নিত অ্যাকাউন্ট

আপনি যদি কোনো পার্টনার লিঙ্ক, প্যারেন্ট গুগল অ্যাডস ম্যানেজার অ্যাকাউন্ট, অথবা প্যারেন্ট ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ পার্টনার অ্যাকাউন্ট ব্যবহার করে parent অ্যাকাউন্ট অ্যাক্সেস করেন, তাহলে রিকোয়েস্ট হেডার সেট করুন।

নির্দিষ্ট বৈশিষ্ট্যযুক্ত রিসোর্সগুলিতে প্রতিক্রিয়া সীমিত করতে ফলাফল ফিল্টার করুন ।

Search মেথডটি ফলাফলের একাধিক পৃষ্ঠা ফেরত দেয়। কোনো অনুরোধের সমস্ত রিসোর্স পুনরুদ্ধার করতে, next_page_token চেক করুন এবং ফলাফলগুলোকে পেজিনেট করুন ।

অনুরোধ হেডার সেট করুন

অনুরোধে parent অ্যাকাউন্টে আপনার ক্রেডেনশিয়ালের অ্যাক্সেস পাথ নির্ধারণ করার জন্য Search মেথডটি login-account হেডার সমর্থন করে। PartnerLinkService মেথডগুলোর জন্য linked-account হেডারটি সমর্থিত নয়।

বিভিন্ন অ্যাক্সেস পরিস্থিতির জন্য হেডারগুলি কীভাবে সেট করতে হয়, সে সম্পর্কে বিস্তারিত বিবরণ ও নির্দেশাবলীর জন্য 'গন্তব্য এবং হেডার' অংশটি দেখুন।

ফলাফল ফিল্টার করুন

নির্দিষ্ট পার্টনার লিঙ্কগুলি পুনরুদ্ধার করতে অনুরোধের filter ফিল্ডটি ব্যবহার করুন। filter ফিল্ডটি একটি স্ট্রিং যা আপনি যে শর্তাবলী প্রয়োগ করতে চান তা নির্ধারণ করে, এবং এর সাথে এটিও নির্ধারণ করে যে API শর্তগুলিকে AND নাকি OR ব্যবহার করে একত্রিত করবে। ফিল্টারিং বিকল্প এবং সিনট্যাক্স সম্পর্কে আরও জানতে AIP-160: Filtering পড়ুন।

আপনি মালিক অ্যাকাউন্ট অথবা পার্টনার অ্যাকাউন্টের account_id ব্যবহার করে filter নির্ধারণ করতে পারেন:

• 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 সেট করেন, তাহলে API প্রতি রেসপন্সে সর্বোচ্চ ১০টি ফলাফল ফেরত দেবে। যদি আপনার অনুরোধের সাথে মেলে এমন ফলাফলের সংখ্যা ১০-এর কম হয়, তাহলে API-টি ১০টির কম ফলাফলও ফেরত দিতে পারে।

ডিফল্ট page_size হলো ৫০ এবং সর্বোচ্চ হলো ১০০০।

যদি একটিমাত্র রেসপন্সে যতগুলো ফলাফল দেখানো সম্ভব তার চেয়ে বেশি ফলাফল থাকে, তাহলে রেসপন্সটিতে একটি next_page_token অন্তর্ভুক্ত থাকবে। পরবর্তী পৃষ্ঠা বা ফলাফলের সেটটি পেতে, page_token ফিল্ডটিকে এই মানটিতে সেট করে একই রিকোয়েস্টটি আবার পাঠান। অন্য সব প্যারামিটার পূর্ববর্তী রিকোয়েস্টের মতোই থাকতে হবে।

যদি রেসপন্সে next_page_token ফিল্ডটি অন্তর্ভুক্ত না থাকে, তাহলে বুঝতে হবে আর কোনো ফলাফল নেই।