পূর্বশর্ত

এই নথিটি আপনার প্রথম ক্লায়েন্ট অ্যাপ্লিকেশন লেখার আগে আপনার যা করা উচিত তা বর্ণনা করে।

একটি Google অ্যাকাউন্ট পান

এই API ব্যবহার করার জন্য আপনার একটি Google অ্যাকাউন্ট প্রয়োজন৷ সেই প্রপার্টিতে সেই পদ্ধতিটিকে কল করার জন্য আপনার অ্যাকাউন্টের একটি প্রদত্ত সম্পত্তিতে উপযুক্ত অনুসন্ধান কনসোলের অনুমতি থাকতে হবে। উদাহরণস্বরূপ, searchAnalytics.query চালানোর জন্য আপনাকে সেই সম্পত্তিতে পড়ার অনুমতি নিতে হবে।

Google সার্চ কনসোল ব্যবহার করে দেখুন

এই API ডকুমেন্টেশন অনুমান করে যে আপনি Google অনুসন্ধান কনসোল ব্যবহার করেছেন এবং আপনি ওয়েব প্রোগ্রামিং ধারণা এবং ওয়েব ডেটা ফর্ম্যাটের সাথে পরিচিত৷

আপনি যদি Google সার্চ কনসোল ব্যবহার না করে থাকেন, তাহলে কোড শুরু করার আগে ইউজার ইন্টারফেস ব্যবহার করে দেখুন। প্রতিটি API সার্চ কনসোলে একটি প্রতিবেদনের কার্যকারিতা উপস্থাপন করে। আপনি প্রাপ্ত ডেটা বোঝার জন্য একটি API ব্যবহার করার আগে আপনার সমতুল্য প্রতিবেদনের ডকুমেন্টেশন পড়া উচিত।

আপনার ক্লায়েন্টের জন্য একটি প্রকল্প এবং শংসাপত্র তৈরি করুন

আপনি Google Search Console-এ অনুরোধ পাঠাতে পারার আগে, আপনাকে Google কে আপনার ক্লায়েন্ট সম্পর্কে বলতে হবে এবং API-এ অ্যাক্সেস সক্রিয় করতে হবে। আপনি একটি প্রকল্প তৈরি করতে Google API কনসোল ব্যবহার করে এটি করেন, যা সেটিংস এবং API অ্যাক্সেস তথ্যের একটি নামকৃত সংগ্রহ, এবং আপনার অ্যাপ্লিকেশন নিবন্ধন করুন৷

টেস্টিং টুল এপিআই ছাড়া সব সার্চ কনসোল API-এর জন্য OAuth2 শংসাপত্র প্রয়োজন। পাইথন এবং জাভা কুইকস্টার্ট গাইডগুলি কীভাবে একটি প্রকল্প তৈরি করতে হয় এবং আপনার ক্লায়েন্টের জন্য শংসাপত্রগুলি পেতে হয় তার বিশদ প্রদান করে।

REST বুঝুন

API চালু করার দুটি উপায় রয়েছে:

আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে REST এর মূল বিষয়গুলি বুঝতে হবে।

REST বেসিক

REST হল সফ্টওয়্যার আর্কিটেকচারের একটি শৈলী যা ডেটা অনুরোধ এবং পরিবর্তন করার জন্য একটি সুবিধাজনক এবং সামঞ্জস্যপূর্ণ পদ্ধতি প্রদান করে।

REST শব্দটি " রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার " এর জন্য সংক্ষিপ্ত। Google API-এর প্রসঙ্গে, এটি Google দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং সংশোধন করার জন্য HTTP ক্রিয়া ব্যবহারকে বোঝায়।

একটি RESTful সিস্টেমে, সম্পদ একটি ডেটা স্টোরে সংরক্ষণ করা হয়; একটি ক্লায়েন্ট একটি অনুরোধ পাঠায় যে সার্ভার একটি নির্দিষ্ট ক্রিয়া সম্পাদন করে (যেমন একটি সংস্থান তৈরি করা, পুনরুদ্ধার করা, আপডেট করা বা মুছে ফেলা), এবং সার্ভার ক্রিয়াটি সম্পাদন করে এবং একটি প্রতিক্রিয়া পাঠায়, প্রায়শই নির্দিষ্ট সংস্থানের উপস্থাপনা আকারে।

Google-এর RESTful API-এ, ক্লায়েন্ট একটি HTTP ক্রিয়া যেমন POST , GET , PUT , বা DELETE ব্যবহার করে একটি ক্রিয়া নির্দিষ্ট করে৷ এটি নিম্নলিখিত ফর্মের একটি বিশ্বব্যাপী-অনন্য URI দ্বারা একটি সংস্থান নির্দিষ্ট করে:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

যেহেতু সমস্ত API সংস্থানগুলিতে অনন্য HTTP- অ্যাক্সেসযোগ্য URI রয়েছে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের বিতরণ করা অবকাঠামোর সাথে কাজ করার জন্য অপ্টিমাইজ করা হয়৷

আপনি HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে পদ্ধতির সংজ্ঞাগুলি দরকারী খুঁজে পেতে পারেন; তারা GET , POST , PUT , এবং DELETE এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।

Google সার্চ কনসোল এপিআই-এ বিশ্রাম নিন

Google সার্চ কনসোল এপিআই অপারেশন সরাসরি REST HTTP ক্রিয়ায় ম্যাপ করে।

বেশিরভাগ গুগল সার্চ কনসোল এপিআই ইউআরআই-এর বিন্যাস এরকম কিছু:

VERB https://www.googleapis.com/webmasters/v3/resourcePath?parameters

প্রতিটি পদ্ধতির জন্য ব্যবহৃত URI এবং ক্রিয়াগুলির সম্পূর্ণ সেট Google অনুসন্ধান কনসোল API রেফারেন্স ওভারভিউতে দেওয়া হয়েছে।

JSON বেসিক বুঝুন

Google Search Console API JSON ফর্ম্যাটে ডেটা প্রদান করে।

JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।