SearchPartnerLinksRequest পাঠিয়ে PartnerLink রিসোর্স ফিরিয়ে আনুন।
অনুরোধের parent ফিল্ডটি পূরণ করতে হবে। এই ফর্ম্যাট ব্যবহার করে, নির্দিষ্ট অ্যাকাউন্টের রিসোর্স
নামে parent সেট করুন:
accountTypes/{account_type}/accounts/{account}
বিভিন্ন ব্যবহারের ক্ষেত্রে নমনীয়তার জন্য, SearchPartnerLinksResponse-এ
সব PartnerLink রিসোর্স থাকে যেখানে অনুরোধে parent
এগুলির মধ্যে যেকোনও একটি:
owner_accountফিল্ডের মাধ্যমে শনাক্ত করা অ্যাকাউন্টpartner_accountফিল্ডের মাধ্যমে শনাক্ত করা অ্যাকাউন্ট
আপনি যদি পার্টনার লিঙ্ক, মূল Google Ads ম্যানেজার অ্যাকাউন্ট বা মূল Display & Video 360 পার্টনার অ্যাকাউন্ট ব্যবহার করে parent অ্যাকাউন্ট অ্যাক্সেস করেন, তাহলে অনুরোধের হেডার সেট করুন।
নির্দিষ্ট অ্যাট্রিবিউট সহ রিসোর্সের মধ্যে উত্তর সীমিত করতে ফলাফল ফিল্টার করুন।
Search পদ্ধতি ফলাফলের পৃষ্ঠা রিটার্ন করে। কোনও অনুরোধের জন্য সব রিসোর্স ফিরিয়ে আনতে, next_page_token চেক করুন এবং ফলাফল পেজিনেট করুন।
রিকোয়েস্ট হেডার সেট করুন
Search পদ্ধতি login-account হেডারকে সমর্থন করে
যাতে অনুরোধে parent অ্যাকাউন্টে আপনার ক্রেডেনশিয়ালের অ্যাক্সেস পাথ
সংজ্ঞায়িত করা যায়। linked-account হেডার PartnerLinkService
পদ্ধতির জন্য কাজ করে না।
বিস্তারিত তথ্য এবং বিভিন্ন অ্যাক্সেস পরিস্থিতির জন্য কীভাবে হেডার সেট করতে হয় সেই সংক্রান্ত নির্দেশাবলীর জন্য গন্তব্য এবং হেডার দেখুন।
ফলাফল ফিল্টার করুন
নির্দিষ্ট পার্টনার লিঙ্ক ফিরিয়ে আনতে অনুরোধের 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
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 ফিল্ড অন্তর্ভুক্ত না থাকলে, এটি ইঙ্গিত করে যে
আর কোনও ফলাফল নেই।