Search Analytics: query

অনুমোদন প্রয়োজন

আপনার সংজ্ঞায়িত ফিল্টার এবং পরামিতি সহ আপনার অনুসন্ধান ট্রাফিক ডেটা জিজ্ঞাসা করুন। পদ্ধতিটি আপনার সংজ্ঞায়িত সারি কী (মাত্রা) দ্বারা গোষ্ঠীবদ্ধ শূন্য বা তার বেশি সারি প্রদান করে। আপনাকে অবশ্যই এক বা একাধিক দিনের একটি তারিখ পরিসীমা নির্ধারণ করতে হবে।

যখন তারিখটি মাত্রাগুলির মধ্যে একটি হয়, তখন ফলাফলের তালিকা থেকে ডেটা ছাড়া যেকোনো দিন বাদ দেওয়া হয়। কোন দিনগুলিতে ডেটা আছে তা জানতে, আগ্রহের তারিখের পরিসরের জন্য তারিখ অনুসারে গোষ্ঠীভুক্ত ফিল্টার ছাড়াই একটি প্রশ্ন জারি করুন৷

ক্রমবর্ধমান ক্লিকের সংখ্যা অনুসারে ফলাফলগুলি সাজানো হয়। যদি দুটি সারিতে একই ক্লিকের সংখ্যা থাকে, তাহলে সেগুলিকে নির্বিচারে সাজানো হয়।

এই পদ্ধতিতে কল করার জন্য পাইথন নমুনা দেখুন।

এপিআই সার্চ কনসোলের অভ্যন্তরীণ সীমাবদ্ধতা দ্বারা আবদ্ধ এবং সমস্ত ডেটা সারি ফেরত দেওয়ার গ্যারান্টি দেয় না বরং শীর্ষগুলি।

উপলভ্য ডেটার পরিমাণের সীমা দেখুন ।

JSON পোস্ট উদাহরণ:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}
এখনই চেষ্টা করে দেখুন ।

অনুরোধ

HTTP অনুরোধ 

POST https://www.googleapis.com/webmasters/v3/sites/siteUrl/searchAnalytics/query

পরামিতি

পরামিতি নাম মান বর্ণনা
পাথ প্যারামিটার
siteUrl string সার্চ কনসোলে সংজ্ঞায়িত প্রপার্টির URL। উদাহরণ: http://www.example.com/ (একটি URL-প্রিফিক্স সম্পত্তির জন্য) বা sc-domain:example.com (একটি ডোমেন সম্পত্তির জন্য)

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/webmasters.readonly
https://www.googleapis.com/auth/webmasters

শরীরের অনুরোধ

অনুরোধের অংশে, নিম্নলিখিত কাঠামোর সাথে ডেটা সরবরাহ করুন: 

{
  "startDate": string,
  "endDate": string,
  "dimensions": [
    string
  ],
  "type": string,
  "dimensionFilterGroups": [
    {
      "groupType": string,
      "filters": [
        {
          "dimension": string,
          "operator": string,
          "expression": string
        }
      ]
    }
  ],
  "aggregationType": string,
  "rowLimit": integer,
  "startRow": integer
}
সম্পত্তির নাম মান বর্ণনা নোট
startDate string [ প্রয়োজনীয় ] অনুরোধকৃত তারিখ সীমার শুরুর তারিখ, YYYY-MM-DD ফর্ম্যাটে, PT সময়ে (UTC - 7:00/8:00) । শেষ তারিখের কম বা সমান হতে হবে। এই মান পরিসীমা অন্তর্ভুক্ত করা হয়.
endDate string [ প্রয়োজনীয় ] অনুরোধকৃত তারিখ সীমার শেষ তারিখ, YYYY-MM-DD ফর্ম্যাটে, PT সময়ে (UTC - 7:00/8:00)। শুরুর তারিখের চেয়ে বড় বা সমান হতে হবে। এই মান পরিসীমা অন্তর্ভুক্ত করা হয়.
dimensions[] list [ ঐচ্ছিক ] গ্রুপের ফলাফলে শূন্য বা তার বেশি মাত্রা। আপনি এই মাত্রাগুলি যেভাবে সরবরাহ করেন সে অনুযায়ী ফলাফলগুলিকে গোষ্ঠীভুক্ত করা হয়। আপনি যেকোনো মাত্রার নাম ব্যবহার করতে পারেন dimensionFilterGroups[].filters[].dimension পাশাপাশি "তারিখ"। প্রতিটি ফলাফল সারির জন্য একটি অনন্য কী তৈরি করতে গ্রুপিং মাত্রা মানগুলিকে একত্রিত করা হয়। কোনো মাত্রা নির্দিষ্ট না থাকলে, সমস্ত মান একটি একক সারিতে মিলিত হবে। আপনি যে মাত্রাগুলি দ্বারা গোষ্ঠীবদ্ধ করতে পারেন তার কোনও সীমা নেই, তবে আপনি একই মাত্রা দ্বারা দুইবার গোষ্ঠীবদ্ধ করতে পারবেন না। উদাহরণ: [দেশ, ডিভাইস]
searchType string অপ্রচলিত, পরিবর্তে type ব্যবহার করুন
type string [ ঐচ্ছিক ] নিম্নলিখিত ধরনের ফলাফল ফিল্টার করুন:
  • " discover ": ফলাফল আবিষ্কার করুন
  • " googleNews ": Android এবং iOS-এ news.google.com এবং Google News অ্যাপ থেকে ফলাফল। Google অনুসন্ধানে "সংবাদ" ট্যাব থেকে ফলাফল অন্তর্ভুক্ত করে না।
  • " news ": গুগল অনুসন্ধানে "সংবাদ" ট্যাব থেকে অনুসন্ধানের ফলাফল।
  • " image ": Google অনুসন্ধানে "চিত্র" ট্যাব থেকে অনুসন্ধানের ফলাফল।
  • " video ": ভিডিও অনুসন্ধান ফলাফল
  • " web ": [ ডিফল্ট ] Google অনুসন্ধানের সম্মিলিত ("সমস্ত") ট্যাবে ফলাফল ফিল্টার করুন। Discover বা Google News ফলাফল অন্তর্ভুক্ত করে না।
dimensionFilterGroups[] list [ ঐচ্ছিক ] ডাইমেনশন গ্রুপিং মানগুলিতে প্রয়োগ করার জন্য ফিল্টারের শূন্য বা তার বেশি গোষ্ঠী৷ প্রতিক্রিয়াতে একটি সারি ফেরানোর জন্য সমস্ত ফিল্টার গ্রুপ অবশ্যই মিলতে হবে। একটি একক ফিল্টার গোষ্ঠীর মধ্যে, আপনি নির্দিষ্ট করতে পারেন যে সমস্ত ফিল্টার অবশ্যই মেলে বা অন্তত একটি অবশ্যই মিলবে কিনা।
dimensionFilterGroups[]. groupType string এই গোষ্ঠীর সমস্ত ফিল্টার অবশ্যই সত্য ("এবং") ফেরত দিতে হবে, বা এক বা একাধিক সত্য ( এখনও সমর্থিত নয়) ফিরতে হবে।

গ্রহণযোগ্য মান হল:
  • " and ": গ্রুপের সমস্ত ফিল্টার অবশ্যই ফিল্টার গ্রুপ টি-এর জন্য সত্য হতে হবে o সত্য হও।
dimensionFilterGroups[]. filters[] list [ ঐচ্ছিক ] সারির বিপরীতে পরীক্ষা করার জন্য শূন্য বা তার বেশি ফিল্টার। প্রতিটি ফিল্টারে একটি মাত্রার নাম, একটি অপারেটর এবং একটি মান থাকে। সর্বোচ্চ দৈর্ঘ্য 4096 অক্ষর। উদাহরণ:
country equals FRA
query contains mobile use
device notContains tablet
dimensionFilterGroups[].filters[]. dimension string এই ফিল্টার যে মাত্রা প্রযোজ্য. আপনি এখানে তালিকাভুক্ত যেকোনো মাত্রা দ্বারা ফিল্টার করতে পারেন, এমনকি যদি আপনি সেই মাত্রা অনুসারে গোষ্ঠীবদ্ধ না হন।

গ্রহণযোগ্য মান হল:
  • " country ": 3-অক্ষরের দেশের কোড ( ISO 3166-1 alpha-3 ) দ্বারা নির্দিষ্ট করা নির্দিষ্ট দেশের বিপরীতে ফিল্টার করুন।
  • " device ": নির্দিষ্ট ডিভাইস প্রকারের বিপরীতে ফলাফল ফিল্টার করুন। সমর্থিত মান:
    • ডেস্কটপ
    • মোবাইল
    • ট্যাবলেট
  • " page ": নির্দিষ্ট URI স্ট্রিং এর বিপরীতে ফিল্টার করুন।
  • " query ": নির্দিষ্ট ক্যোয়ারী স্ট্রিং এর বিপরীতে ফিল্টার করুন।
  • " searchAppearance ": একটি নির্দিষ্ট অনুসন্ধান ফলাফল বৈশিষ্ট্যের বিপরীতে ফিল্টার করুন। উপলব্ধ মানগুলির একটি তালিকা দেখতে, "অনুসন্ধান চেহারা" দ্বারা গোষ্ঠীবদ্ধ একটি প্রশ্ন চালান৷ মান এবং বর্ণনার সম্পূর্ণ তালিকা সাহায্য ডকুমেন্টেশনেও পাওয়া যায়।
dimensionFilterGroups[].filters[]. operator string [ ঐচ্ছিক ] কিভাবে আপনার নির্দিষ্ট মানটি সারির মাত্রার মানের সাথে মেলে (বা মেলে না)।

গ্রহণযোগ্য মান হল:
  • " contains ": সারি মান অবশ্যই আপনার অভিব্যক্তি ধারণ করবে বা সমান হবে (অ-কেস-সংবেদনশীল)।
  • " equals ": [ ডিফল্ট ] আপনার অভিব্যক্তিটি অবশ্যই সারি মানের সমান হবে (পৃষ্ঠা এবং ক্যোয়ারী মাত্রার জন্য কেস-সংবেদনশীল)।
  • " notContains ": সারি মান একটি সাবস্ট্রিং বা একটি (নন-কেস-সংবেদনশীল) সম্পূর্ণ মিল হিসাবে আপনার অভিব্যক্তি ধারণ করা উচিত নয়।
  • " notEquals ": আপনার অভিব্যক্তিটি অবশ্যই সারি মানের সমান হবে না (পৃষ্ঠা এবং ক্যোয়ারী মাত্রার জন্য কেস-সংবেদনশীল)।
  • " includingRegex ": একটি RE2 সিনট্যাক্স রেগুলার এক্সপ্রেশন যা অবশ্যই মিলতে হবে।
  • " excludingRegex ": একটি RE2 সিনট্যাক্স রেগুলার এক্সপ্রেশন যা অবশ্যই মেলে না।
dimensionFilterGroups[].filters[]. expression string অপারেটরের উপর নির্ভর করে ফিল্টারের সাথে মিল বা বাদ দেওয়ার মান।
aggregationType string

[ ঐচ্ছিক ] কিভাবে ডেটা একত্রিত করা হয়। সম্পত্তি দ্বারা একত্রিত হলে, একই সম্পত্তির জন্য সমস্ত ডেটা একত্রিত হয়; পৃষ্ঠা দ্বারা একত্রিত হলে, সমস্ত ডেটা ক্যানোনিকাল URI দ্বারা একত্রিত হয়। আপনি যদি পৃষ্ঠা অনুসারে ফিল্টার বা গ্রুপ করেন, অটো বেছে নিন; অন্যথায় আপনি সম্পত্তি বা পৃষ্ঠা দ্বারা একত্রিত করতে পারেন, আপনি কীভাবে আপনার ডেটা গণনা করতে চান তার উপর নির্ভর করে; সাইট বনাম পৃষ্ঠা অনুসারে ডেটা কীভাবে আলাদাভাবে গণনা করা হয় তা জানতে সহায়তা ডকুমেন্টেশন দেখুন।

দ্রষ্টব্য: আপনি যদি পৃষ্ঠা অনুসারে গোষ্ঠী বা ফিল্টার করেন তবে আপনি সম্পত্তি দ্বারা একত্রিত করতে পারবেন না।

আপনি যদি স্বয়ংক্রিয় ছাড়া অন্য কোনো মান উল্লেখ করেন, তাহলে ফলাফলে একত্রিতকরণের ধরন অনুরোধ করা প্রকারের সাথে মিলবে, অথবা যদি আপনি একটি অবৈধ প্রকারের অনুরোধ করেন, আপনি একটি ত্রুটি পাবেন। এপিআই কখনই আপনার একত্রিতকরণের ধরন পরিবর্তন করবে না যদি অনুরোধ করা প্রকারটি অবৈধ হয়।

গ্রহণযোগ্য মান হল:
  • " auto ": [ ডিফল্ট ] পরিষেবাটিকে উপযুক্ত একত্রিতকরণের ধরণ নির্ধারণ করতে দিন৷
  • " byNewsShowcasePanel " দ্বারা: নিউজ শোকেস প্যানেল দ্বারা সমষ্টিগত মান। এটি অবশ্যই NEWS_SHOWCASE searchAppearance ফিল্টার এবং হয় type=discover বা type=googleNews এর সাথে একত্রে ব্যবহার করতে হবে। আপনি যদি পৃষ্ঠা অনুসারে গ্রুপ করেন, পৃষ্ঠা অনুসারে ফিল্টার করেন বা অন্য searchAppearance ফিল্টার করেন, তাহলে আপনি byNewsShowcasePanel দ্বারা একত্রিত করতে পারবেন না।
  • " byPage ": URI দ্বারা সমষ্টিগত মান।
  • " byProperty ": সম্পত্তি দ্বারা সমষ্টিগত মান। type=discover বা type=googleNews এর জন্য সমর্থিত নয়
rowLimit integer [ ঐচ্ছিক; বৈধ পরিসীমা হল 1-25,000; ডিফল্ট হল 1,000 ] ফেরার জন্য সর্বাধিক সংখ্যক সারি৷ ফলাফলের মাধ্যমে পৃষ্ঠা করতে, startRow অফসেট ব্যবহার করুন।
startRow integer [ ঐচ্ছিক; ডিফল্ট হল 0 ] প্রতিক্রিয়ার প্রথম সারির শূন্য-ভিত্তিক সূচক। একটি নন-নেতিবাচক সংখ্যা হতে হবে। যদি startRow কোয়েরির ফলাফলের সংখ্যা ছাড়িয়ে যায়, তাহলে শূন্য সারি সহ প্রতিক্রিয়াটি সফল প্রতিক্রিয়া হবে।
dataState string [ ঐচ্ছিক ] যদি "সমস্ত" (কেস-সংবেদনশীল), ডেটাতে নতুন ডেটা অন্তর্ভুক্ত করা হবে। যদি "চূড়ান্ত" (কেস-সংবেদনশীল) বা যদি এই প্যারামিটারটি বাদ দেওয়া হয়, তবে প্রত্যাবর্তিত ডেটা শুধুমাত্র চূড়ান্ত ডেটা অন্তর্ভুক্ত করবে।

প্রতিক্রিয়া

অনুরোধে উল্লিখিত মাত্রা অনুযায়ী ফলাফল গোষ্ঠীবদ্ধ করা হয়। মাত্রার মানগুলির একই সেট সহ সমস্ত মান একটি একক সারিতে গোষ্ঠীবদ্ধ হবে৷ উদাহরণ স্বরূপ, আপনি যদি দেশের মাত্রা অনুসারে গোষ্ঠী করেন, তাহলে "usa"-এর সমস্ত ফলাফল একসঙ্গে গোষ্ঠীভুক্ত করা হবে, "mdv"-এর সমস্ত ফলাফল একসঙ্গে গোষ্ঠীভুক্ত করা হবে, ইত্যাদি৷ আপনি যদি দেশ এবং ডিভাইস অনুসারে গোষ্ঠীভুক্ত করেন, তাহলে "usa, tablet"-এর জন্য সমস্ত ফলাফল গোষ্ঠীভুক্ত করা হবে, "usa, mobile"-এর সমস্ত ফলাফল গোষ্ঠীভুক্ত করা হবে, ইত্যাদি৷ কিভাবে ক্লিক, ইমপ্রেশন ইত্যাদি গণনা করা হয় এবং এর অর্থ কী তা জানতে অনুসন্ধান বিশ্লেষণ প্রতিবেদন ডকুমেন্টেশন দেখুন।

ফলাফলগুলিকে ক্লিকের সংখ্যা অনুসারে সাজানো হয়, অবরোহ ক্রমে, যদি না আপনি তারিখ অনুসারে গোষ্ঠীবদ্ধ হন, সেক্ষেত্রে ফলাফলগুলি তারিখ অনুসারে বাছাই করা হয়, আরোহী ক্রমে (প্রাচীনতম প্রথম, সর্বশেষ সর্বশেষ)। যদি দুটি সারির মধ্যে একটি টাই থাকে, বাছাই ক্রম নির্বিচারে হয়।

দেখুন রিটার্ন করা যেতে পারে এমন সর্বাধিক সংখ্যক মান শেখার অনুরোধে rowLimit সম্পত্তি। 

{
  "rows": [
    {
      "keys": [
        string
      ],
      "clicks": double,
      "impressions": double,
      "ctr": double,
      "position": double
    }
  ],
  "responseAggregationType": string
}
সম্পত্তির নাম মান বর্ণনা নোট
rows[] list প্রশ্নে প্রদত্ত ক্রম অনুসারে মূল মান দ্বারা গোষ্ঠীবদ্ধ সারিগুলির একটি তালিকা৷
rows[]. keys[] list সেই সারির মাত্রার মানগুলির একটি তালিকা, অনুরোধের মাত্রা অনুযায়ী, অনুরোধে উল্লেখিত ক্রমে গোষ্ঠীবদ্ধ।
rows[]. clicks double সারি জন্য গণনা ক্লিক করুন.
rows[]. impressions double সারির জন্য ছাপ গণনা।
rows[]. ctr double সারির জন্য থ্রু রেট (CTR) এ ক্লিক করুন। মান 0 থেকে 1.0 পর্যন্ত, অন্তর্ভুক্ত।
rows[]. position double সার্চ ফলাফলে গড় অবস্থান।
responseAggregationType string ফলাফলগুলি কীভাবে একত্রিত হয়েছিল। সাইট বনাম পৃষ্ঠা অনুসারে ডেটা কীভাবে আলাদাভাবে গণনা করা হয় তা জানতে সহায়তা ডকুমেন্টেশন দেখুন ।

গ্রহণযোগ্য মান হল:
  • " auto "
  • " byPage ": ফলাফল পৃষ্ঠা দ্বারা একত্রিত করা হয়েছে.
  • " byProperty ": ফলাফলগুলি সম্পত্তি দ্বারা একত্রিত হয়েছিল৷

এটা চেষ্টা করুন!

লাইভ ডেটাতে এই পদ্ধতিতে কল করতে এবং প্রতিক্রিয়া দেখতে নীচের APIs এক্সপ্লোরার ব্যবহার করুন।