পৃষ্ঠায় ক্যোয়ারী ফলাফল

প্রচুর সংখ্যক সারি সমন্বিত ফলাফল সেট পরিচালনা করার জন্য, Merchant Center Query Language পেজিনেশন সমর্থন করে। দুইটি পরামিতি প্রতিবেদনে পৃষ্ঠা সংখ্যা নিয়ন্ত্রণের জন্য উপলব্ধ । reports.search অনুরোধের বডি : page_size এবং page_token , প্রতিক্রিয়া বডিতে একটি আউটপুট ক্ষেত্র ছাড়াও: next_page_token ।

page_size প্যারামিটারটি একটি অনুরোধে পুনরুদ্ধারের জন্য সর্বাধিক সংখ্যক সারি নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, এটি স্বয়ংক্রিয়ভাবে 1000 সারির সর্বোচ্চ পৃষ্ঠা আকারে সেট করা হয়।

page_token প্যারামিটারটি পৃষ্ঠার টোকেনটি ফেরত দেওয়ার জন্য নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, প্রথম পৃষ্ঠাটি ফেরত দেওয়া হয়। একটি পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে, পূর্ববর্তী reports.search থেকে next_page_token হিসাবে প্রাপ্ত মানটিকে একটি page_token হিসাবে প্রদান করা উচিত। যখন একটি page_token প্রদান করা হয়, তখন কলের অন্যান্য সমস্ত প্যারামিটারগুলি পূর্ববর্তী কলের সাথে মিলিত হওয়া উচিত যা অপ্রত্যাশিত আচরণ এড়াতে page_token ফেরত দিয়েছে।

উদাহরণ:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

এই প্রশ্নের জন্য, ধরে নিন অ্যাকাউন্টটিতে 100,000 offer_ids রয়েছে এবং page_size 200-এ সেট করা হয়েছে। ফলাফল সেটে তারপর একটি next_page_token সহ প্রথম প্রতিক্রিয়ায় 200টি ReportRow অবজেক্ট থাকবে।

পরবর্তী 200টি সারি পুনরুদ্ধার করতে, একই পৃষ্ঠার আকারের সাথে অনুরোধটি আবার পাঠান, কিন্তু অনুরোধের page_token পূর্ববর্তী প্রতিক্রিয়ার next_page_token এ আপডেট করুন।

এখানে একটি প্রতিক্রিয়া প্রধান উদাহরণ (প্রথম পাঁচটি ফলাফল এবং next_page_token ):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}

মূল পয়েন্ট: next_page_token সারিগুলির শেষ ব্যাচ ধারণ করে এমন প্রতিক্রিয়াতে পপুলেট করা হয় না।