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

SearchPartnerLinksRequest পাঠিয়ে PartnerLink রিসোর্সগুলি পুনরুদ্ধার করুন।

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

accountTypes/{account_type}/accounts/{account}

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

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

যদি আপনি কোনও পার্টনার লিঙ্ক, কোনও প্যারেন্ট Google Ads ম্যানেজার অ্যাকাউন্ট, অথবা কোনও প্যারেন্ট ডিসপ্লে এবং ভিডিও 360 পার্টনার অ্যাকাউন্ট ব্যবহার করে parent অ্যাকাউন্ট অ্যাক্সেস করেন, তাহলে অনুরোধের শিরোনাম সেট করুন।

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

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

অনুরোধের শিরোনাম সেট করুন

Search পদ্ধতিটি অনুরোধে আপনার শংসাপত্রের parent অ্যাকাউন্টে অ্যাক্সেস পাথ নির্ধারণ করার জন্য login-account এবং linked-account হেডারগুলিকে সমর্থন করে। বিভিন্ন অ্যাক্সেস পরিস্থিতির জন্য হেডার কীভাবে সেট করবেন তার বিশদ এবং নির্দেশাবলীর জন্য গন্তব্য এবং হেডারগুলি দেখুন।

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

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

আপনি মালিকানাধীন অ্যাকাউন্ট অথবা অংশীদার অ্যাকাউন্টের 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

filter OR এর পরিবর্তে AND ব্যবহার করার জন্য পরিবর্তন করলে রিটার্ন করা রিসোর্সগুলি পার্টনার লিঙ্কগুলিতে সীমাবদ্ধ থাকে যেখানে মালিকানাধীন অ্যাকাউন্টের অ্যাকাউন্ট আইডি 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 প্রতি প্রতিক্রিয়ায় সর্বাধিক 10টি ফলাফল প্রদান করবে। আপনার অনুরোধের সাথে মিলে যাওয়া 10টিরও কম ফলাফল থাকলে API 10টিরও কম ফলাফল প্রদান করতে পারে।

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

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

যদি next_page_token ক্ষেত্রটি প্রতিক্রিয়ায় অন্তর্ভুক্ত না করা হয়, তাহলে এর অর্থ হল আর কোনও ফলাফল নেই।