অনুমোদন প্রয়োজন
আপনার সার্চ ট্রাফিক ডেটা আপনার নির্ধারিত ফিল্টার ও প্যারামিটার দিয়ে কোয়েরি করুন। এই পদ্ধতি আপনার উল্লেখ করা সারি কী (ডাইমেনশন) অনুযায়ী গ্রুপ করা শূন্য বা তার বেশি সারি দেখায়। আপনাকে এক বা একাধিক দিনের তারিখের রেঞ্জ উল্লেখ করতে হবে।
তারিখ যদি ডাইমেনশনের মধ্যে একটি হয়, তাহলে ডেটা ছাড়া যেকোনও দিন ফলাফলের তালিকা থেকে বাদ দেওয়া হয়। কোন কোন দিনের ডেটা আছে তা জানতে, তারিখ অনুযায়ী গ্রুপ করা ফিল্টার ছাড়া কোয়েরি ইস্যু করুন, আপনার আগ্রহের তারিখের রেঞ্জের জন্য।
ক্লিক সংখ্যার ভিত্তিতে বড় থেকে ছোট ক্রমে ফলাফল সাজানো হয়েছে। দুটি সারিতে একই ক্লিক সংখ্যা থাকলে, সেগুলি ইচ্ছামতো সাজানো হয়।
এই পদ্ধতি কল করার জন্য python স্যাম্পেল দেখুন।
Search Console-এর অভ্যন্তরীণ সীমাবদ্ধতার কারণে API-এর উপর কিছু বিধিনিষেধ আছে এবং এটি সব ডেটা রো দেখানোর গ্যারেন্টি দেয় না, তবে সবচেয়ে গুরুত্বপূর্ণ ডেটা রো দেখায়।
উপলভ্য ডেটার পরিমাণের সীমা দেখুন।
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 |
Search Console-এ উল্লেখ করা প্রপার্টির 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
}
],
"filterLists": [
{
"dimension": string,
"expressions": [
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 |
[ঐচ্ছিক] নিম্নলিখিত ধরনের ফলাফল ফিল্টার করুন:
|
|
dimensionFilterGroups[] |
list |
[ঐচ্ছিক] ডাইমেনশন গ্রুপিং ভ্যালুতে প্রয়োগ করার জন্য ফিল্টারের শূন্য বা তার বেশি গ্রুপ। উত্তরে কোনও সারি ফেরত পেতে হলে সব ফিল্টার গ্রুপকে ম্যাচ করতে হবে। একটি ফিল্টার গ্রুপের মধ্যে, আপনি নির্দিষ্ট করতে পারেন যে সব ফিল্টার মিলতে হবে নাকি অন্তত একটি মিলতে হবে। | |
dimensionFilterGroups[].groupType |
string |
এই গ্রুপের সব ফিল্টারকে অবশ্যই সত্য ("এবং") রিটার্ন করতে হবে, অথবা এক বা একাধিককে অবশ্যই সত্য (এখনও কাজ করে না) রিটার্ন করতে হবে।
গ্রহণযোগ্য ভ্যালু হল:
|
|
dimensionFilterGroups[].filters[] |
list |
[ঐচ্ছিক] সারির সাথে তুলনা করে পরীক্ষা করার জন্য শূন্য বা তার বেশি ফিল্টার। প্রতিটি ফিল্টারে
একটি ডাইমেনশনের নাম, একটি অপারেটর এবং একটি ভ্যালু থাকে। সর্বাধিক ৪০৯৬টি অক্ষর লেখা যাবে। উদাহরণ:
country equals FRA query contains mobile use device notContains tablet |
|
dimensionFilterGroups[].filters[].dimension |
string |
এই ফিল্টার যে ডাইমেনশনে প্রয়োগ করা হয়। আপনি এখানে তালিকাভুক্ত যেকোনও ডাইমেনশন অনুযায়ী ফিল্টার করতে পারবেন, এমনকি আপনি সেই ডাইমেনশন অনুযায়ী গ্রুপ না করলেও।
গ্রহণযোগ্য ভ্যালু হল:
|
|
dimensionFilterGroups[].filters[].operator |
string |
[ঐচ্ছিক] আপনার নির্দিষ্ট করা ভ্যালু কীভাবে সারির ডাইমেনশন ভ্যালুর সাথে মিলতে (বা নাও মিলতে) হবে।
গ্রহণযোগ্য ভ্যালু হল:
|
|
dimensionFilterGroups[].filters[].expression |
string |
অপারেটরের উপর নির্ভর করে, ফিল্টারের জন্য যে ভ্যালু ম্যাচ করতে হবে বা বাদ দিতে হবে। | |
dimensionFilterGroups[].filterLists[] |
list |
[ঐচ্ছিক] সারির বিপরীতে পরীক্ষা করার জন্য শূন্য বা তার বেশি মাল্টি-ভ্যালু ডাইমেনশন ফিল্টার।
filters[]-এর মতো নয়, যা প্রতিটি এন্ট্রির জন্য একটি একক মান মেলে,
filterLists[] একটি ফিল্টারে একটি একক ডাইমেনশনের জন্য একাধিক সম্পূর্ণ-মিল মানের সাথে
মেলানোর অনুমতি দেয়। কোনও সারির নির্দিষ্ট dimension-এর ভ্যালু যদি প্রদত্ত যেকোনও expressions-এর সমান হয়,
তাহলে সেই সারিটি ফিল্টার তালিকার সাথে মিলে যায়। মনে রাখবেন যে একটি
অনুরোধের মাধ্যমে একই সাথে filters এবং
filterLists-এর একই ডাইমেনশনে ফিল্টার করা যাবে না। |
|
dimensionFilterGroups[].filterLists[].dimension |
string |
[প্রয়োজনীয়] এই ফিল্টার তালিকা যে ডাইমেনশনে প্রযোজ্য।
গ্রহণযোগ্য ভ্যালু হল:
|
|
dimensionFilterGroups[].filterLists[].expressions[] |
list |
[প্রয়োজনীয়] ফিল্টার করার জন্য ভ্যালুর তালিকা (string)। |
|
aggregationType |
string |
[ঐচ্ছিক] কীভাবে ডেটা একত্রিত করা হয়। প্রপার্টি অনুযায়ী এগ্রিগেট করা হলে, একই প্রপার্টির সব ডেটা এগ্রিগেট করা হয়; পৃষ্ঠা অনুযায়ী এগ্রিগেট করা হলে, ক্যানোনিকাল URI অনুযায়ী সব ডেটা এগ্রিগেট করা হয়। আপনি যদি পৃষ্ঠা অনুযায়ী ফিল্টার বা গ্রুপ করেন, তাহলে অটোমেটিক বেছে নিন; অন্যথায়, আপনি কীভাবে আপনার ডেটা গণনা করতে চান তার উপর নির্ভর করে প্রপার্টি বা পৃষ্ঠা অনুযায়ী একত্রিত করতে পারেন; সাইট বনাম পৃষ্ঠা অনুযায়ী কীভাবে ডেটা আলাদাভাবে গণনা করা হয় তা জানতে সহায়তা ডকুমেন্টেশন দেখুন। মনে রাখবেন: আপনি পৃষ্ঠা অনুযায়ী গ্রুপ বা ফিল্টার করলে, প্রপার্টি অনুযায়ী অ্যাগ্রিগেট করতে পারবেন না। আপনি যদি অটো ছাড়া অন্য কোনও ভ্যালু নির্দিষ্ট করেন, তাহলে ফলাফলে এগ্রিগেশনের ধরন অনুরোধ করা ধরনের সাথে মিলবে, অথবা আপনি যদি কোনও ভুল ধরনের অনুরোধ করেন, তাহলে আপনি একটি ত্রুটি পাবেন। অনুরোধ করা অ্যাগ্রিগেশনের ধরন সঠিক না হলে, API কখনই আপনার অ্যাগ্রিগেশনের ধরন পরিবর্তন করবে না। গ্রহণযোগ্য মান হল:
|
|
rowLimit |
integer |
[ঐচ্ছিক; সঠিক রেঞ্জ হল ১–২৫,০০০; ডিফল্ট হল ১,০০০] সর্বাধিক যতগুলি সারি ফেরত পাঠানো হবে। ফলাফলের মাধ্যমে পৃষ্ঠা দেখতে, startRow অফসেট ব্যবহার করুন। |
|
startRow |
integer |
[ঐচ্ছিক; ডিফল্ট হল ০] উত্তরে প্রথম সারির শূন্য-ভিত্তিক ইন্ডেক্স। অবশ্যই নেগেটিভ নয় এমন সংখ্যা হতে হবে। যদি startRow কোয়েরির জন্য ফলাফলের সংখ্যা অতিক্রম করে, তাহলে উত্তরটি শূন্য সারি সহ একটি সফল উত্তর হবে। |
|
dataState |
string |
[ঐচ্ছিক] "সব" (কেস-ইনসেনসিটিভ) হলে, ডেটাতে নতুন ডেটা অন্তর্ভুক্ত থাকবে। "final" (কেস-ইনসেনসিটিভ) হলে বা এই প্যারামিটার বাদ দেওয়া হলে, ফেরত পাঠানো ডেটায় শুধু চূড়ান্ত করা ডেটা অন্তর্ভুক্ত থাকবে। "hourly_all" (কেস-ইনসেনসিটিভ) হলে, ডেটাতে প্রতি ঘণ্টার ব্রেকডাউন অন্তর্ভুক্ত থাকবে। এটি দেখাবে যে প্রতি ঘণ্টার ডেটায় আংশিক ডেটা অন্তর্ভুক্ত আছে এবং HOUR API ডাইমেনশন অনুযায়ী গ্রুপ করার সময় ব্যবহার করা উচিত। |
রেসপন্স
অনুরোধে উল্লেখ করা ডাইমেনশন অনুযায়ী ফলাফল গ্রুপ করা হয়। একই ডাইমেনশন ভ্যালু সেট সহ সব ভ্যালু একটি সারিতে গ্রুপ করা হবে। যেমন, আপনি যদি দেশের ডাইমেনশন অনুযায়ী গ্রুপ করেন, তাহলে "usa"-এর সব ফলাফল একসাথে গ্রুপ করা হবে, "mdv"-এর সব ফলাফল একসাথে গ্রুপ করা হবে এবং আরও অনেক কিছু। আপনি যদি দেশ ও ডিভাইস অনুযায়ী গ্রুপ করেন, তাহলে "মার্কিন যুক্তরাষ্ট্র, ট্যাবলেট"-এর সব ফলাফল গ্রুপ করা হবে, "মার্কিন যুক্তরাষ্ট্র, মোবাইল"-এর সব ফলাফল গ্রুপ করা হবে এবং এইভাবে চলতে থাকবে। ক্লিক, ইম্প্রেশন এবং আরও অনেক কিছু কীভাবে গণনা করা হয় এবং সেগুলির অর্থ কী তা জানতে সার্চ অ্যানালিটিক্স রিপোর্ট ডকুমেন্টেশন দেখুন।
আপনি তারিখ অনুসারে গ্রুপ না করলে, ফলাফলগুলি ক্লিক সংখ্যা অনুসারে, নিম্নক্রম অনুসারে সাজানো হয়, সেক্ষেত্রে ফলাফলগুলি তারিখ অনুসারে, ঊর্ধ্বক্রম অনুসারে সাজানো হয় (সবচেয়ে পুরনো প্রথমে, সবচেয়ে নতুন শেষে)। দুটি সারির মধ্যে টাই হলে, ক্রমানুসারে সাজানোর সেটিং ইচ্ছামতো হয়।
সর্বাধিক কতগুলি ভ্যালু ফেরত দেওয়া যেতে পারে তা জানতে, অনুরোধে 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)। ভ্যালুর রেঞ্জ ০ থেকে ১.০ পর্যন্ত, এই দুটি ধরে। | |
rows[].position |
double |
সার্চ ফলাফলে গড় অবস্থান। | |
responseAggregationType |
string |
ফলাফল কীভাবে একত্রিত করা হয়েছে। সাইট বনাম পৃষ্ঠা অনুযায়ী কীভাবে ডেটা আলাদাভাবে গণনা করা হয় তা জানতে সহায়তা ডকুমেন্টেশন দেখুন।
গ্রহণযোগ্য ভ্যালু হল:
|
|
metadata |
object |
আপনার কোয়েরি ফলাফলের সাথে একটি অবজেক্ট দেখানো হতে পারে, যা ডেটার অবস্থা সম্পর্কে কনটেক্সট প্রদান করে। আপনি সাম্প্রতিক ডেটার জন্য অনুরোধ করলে ( এই অবজেক্টে উল্লেখ করা সব তারিখ ও সময় এই অবজেক্টের মধ্যে ফেরত আসা নির্দিষ্ট ফিল্ড নির্ভর করে আপনি কীভাবে অনুরোধে আপনার ডেটা গ্রুপ করেছেন তার উপর:
|
এটি ব্যবহার করে দেখুন!
লাইভ ডেটাতে এই পদ্ধতি কল করতে এবং উত্তর দেখতে নিচে দেওয়া APIs Explorer ব্যবহার করুন।