ইন্ডেক্সিং এপিআই ব্যবহারের পূর্বশর্ত

আগেই না করে থাকলে, ইন্ডেক্সিং এপিআইয়ের ব্যবহার শুরু করার আগে আপনাকে এগুলি করতে হবে:

আপনার ক্লায়েন্টের জন্য একটি প্রোজেক্ট তৈরি করা

ইন্ডেক্সিং এপিআইয়ে অনুরোধ পাঠানোর আগে, আপনার ক্লায়েন্ট সম্পর্কে Google-কে জানাতে হবে এবং এপিআইয়ে অ্যাক্সেস চালু করতে হবে। এটি করতে, Google API Console ব্যবহার করে আপনাকে একটি প্রোজেক্ট তৈরি করতে হবে যা হল সেটিংস ও এপিআই অ্যাক্সেস সংক্রান্ত তথ্যের নামকরণ করা একটি সংগ্রহ। তারপরে, আপনার অ্যাপ্লিকেশন রেজিস্টার করতে হবে।

ইন্ডেক্সিং এপিআই ব্যবহার করা শুরু করতে, প্রথমে সেট-আপ টুল ব্যবহার করুন। এটি আপনাকে Google API Console ব্যবহার করে প্রোজেক্ট তৈরি করা, এপিআই চালু করা ও ক্রেডেনশিয়াল তৈরি করার সময় গাইড করে।

পরিষেবার অ্যাকাউন্ট তৈরি করা

  1. পরিষেবার অ্যাকাউন্ট-এর পৃষ্ঠা খুলুন। জিজ্ঞাসা করা হলে, কোনও প্রোজেক্ট বেছে নিন।
  2. add পরিষেবার অ্যাকাউন্ট তৈরি করুন বিকল্পে ক্লিক করুন এবং পরিষেবার অ্যাকাউন্টের নাম ও বিবরণ লিখুন। আপনি ডিফল্ট পরিষেবা অ্যাকাউন্টের আইডি ব্যবহার করতে পারেন অথবা ভিন্ন একটি অনন্য আইডি বেছে নিতে পারেন। হয়ে গেলে তৈরি করুন বিকল্পে ক্লিক করুন।
  3. পরিষেবা অ্যাকাউন্টের অনুমতি (ঐচ্ছিক) বিভাগটির প্রয়োজন নেই। চালিয়ে যান বিকল্পে ক্লিক করুন।
  4. ব্যবহারকারীদের এই পরিষেবা অ্যাকাউন্ট অ্যাক্সেসের অনুমোদন দেওয়ার স্ক্রিন স্ক্রল ডাউন করে কী তৈরি করুন বিভাগে যান। add কী তৈরি করুন বিকল্পে ক্লিক করুন।
  5. সাইড প্যানেল যেটি দেখা যাচ্ছে, তাতে আপনার কী-এর ফর্ম্যাট বেছে নিন: JSON সাজেস্ট করা হচ্ছে।
  6. তৈরি করুন বিকল্পে ক্লিক করুন। এক জোড়া নতুন সর্বজনীন/ব্যক্তিগত কী তৈরি হয়ে আপনার মেশিনে ডাউনলোড হয়ে যাবে; এটি আপনার কী-এর একমাত্র কপি হিসেবে কাজ করবে। এটি কীভাবে নিরাপদে স্টোর করবেন, এই তথ্য জানতে পরিষেবা অ্যাকাউন্ট কী ম্যানেজ করা দেখুন।
  7. আপনার কম্পিউটারে ব্যক্তিগত কী সেভ করা হয়েছে ডায়লগে বন্ধ করুন বিকল্পে ক্লিক করুন, তারপরে আপনার পরিষেবা অ্যাকাউন্টের সারণীতে ফিরে আসতে হয়ে গেছে বিকল্পে ক্লিক করুন।

নিচে উল্লেখ করা ধাপগুলি শুধুমাত্র তখনই প্রয়োজন যখন পরিষেবা অ্যাকাউন্টে আপনি G Suite-কে সমস্ত ডোমেন জুড়ে অথরিটির অনুমোদন দেবেন।

  1. সারণীতে নতুন তৈরি করা পরিষেবা অ্যাকাউন্টের লোকেশন নির্দিষ্ট করুন। অ্যাকশন বিকল্পের মধ্যে, more_vert এডিট বিকল্পে ক্লিক করুন।
  2. পরিষেবার অ্যাকাউন্টের বিবরণ থেকে expand_more ডোমেন জুরে ডেলিগেশন দেখুন বিকল্পে ক্লিক করুন, তারপরে G Suite-এর ডোমেন জুড়ে ডেলিগেশন চালু করুন বিকল্পের চেকবক্সে টিক চিহ্ন দেওয়া আছে কিনা তা ভাল করে দেখে নিন।
  3. আপনার অ্যাপের OAuth সংক্রান্ত সম্মতি স্ক্রিন এখনও কনফিগার না করে থাকলে, সমস্ত ডোমেন জুড়ে ডেলিগেশন চালু করার আগে আপনি এটি অবশ্যই করে নেবেন। OAuth সংক্রান্ত সম্মতি কনফিগার করতে স্ক্রিনে দেওয়া নির্দেশ অনুসরণ করুন তারপরে উপরে উল্লেখ করা ধাপ আবার অনুসরণ করে চেকবক্স আবার চেক করুন।
  4. পরিষেবা অ্যাকাউন্ট আপডেট করতে সেভ করুন বিকল্পে ক্লিক করুন এবং পরিষেবা অ্যাকাউন্টের সারণীতে ফিরে যান। নতুন কলাম, সমস্ত ডোমেন জুড়ে ডেলিগেশন দেখা যেতে পারে। ক্লায়েন্ট আইডি জানতে এবং সেই সম্পর্কে নোট তৈরি করতে ক্লায়েন্ট আইডি দেখুন বিকল্পে ক্লিক করুন।

Search Console-এ সাইটের মালিকানা যাচাই করা

এই ধাপে, ওয়েব প্রপার্টির উপর আপনার নিয়ন্ত্রণ আপনি যাচাই করতে পারবেন।

আপনার সাইটের মালিকানা যাচাই করতে:

  1. আপনার প্রপার্টির মালিকানা যাচাই করার জন্য সাজেস্ট করা ধাপগুলি অনুসরণ করুন।
  2. প্রপার্টি যাচাই করা হয়ে গেলে Search Console খুলুন।
  3. আপনার যাচাই করা প্রপার্টিতে ক্লিক করুন।
  4. যাচাই করা প্রপার্টির পাশে সেটিংস গিয়ার থেকে যাচাইয়ের বিবরণ বেছে নিন।
  5. যাচাই করা মালিক বিকল্প থেকে একজন মালিক যোগ করুন বিকল্পে ক্লিক করুন।
  6. প্রপার্টির একজন মালিক হিসেবে আপনার পরিষেবা অ্যাকাউন্টের ইমেল আইডি যোগ করুন। আপনার পরিষেবা অ্যাকাউন্টের ইমেল আইডি আপনি দু'টি জায়গা থেকে খুঁজে পাবেন:
    • প্রোজেক্ট তৈরি করার সময় যে JSON ব্যক্তিগত কী আপনি ডাউনলোড করেছিলেন সেটির client_email ফিল্ড থেকে পাবেন।
    • ডেভেলপার কনসোল-এর পরিষেবা অ্যাকাউন্টের ভিউয়ের পরিষেবা অ্যাকাউন্টের আইডি কলাম থেকে পাবেন।

    ইমেল আইডিটি নিম্নলিখিত ফর্ম্যাটে থাকে:

    my-service-account@project-name.google.com.iam.gserviceaccount.com

    যেমন, "my-service-account@test-project-42.google.com.iam.gserviceaccount.com"

অ্যাক্সেস টোকেন পান

ইন্ডেক্সিং এপিআইকে কল করতে, সেটি আপনার ব্যক্তিগত কীয়ের বিনিময়ে পাওয়া OAuth টোকেন দ্বারা যাচাই করা হতে হবে। যাতে একাধিক ভাষায় OAuth টোকেন পাওয়া যায় সেই জন্য Google, এপিআই ক্লায়েন্ট লাইব্রেরি প্রদান করে।

প্রয়োজনীয়তা

ইন্ডেক্সিং এপিআইয়ে অনুরোধ জমা দেওয়ার সময় আপনার অনুরোধে অবশ্যই:

  1. স্কোপ হিসেবে https://www.googleapis.com/auth/indexing ব্যবহার করুন।
  2. এপিআই ব্যবহার করা নিবন্ধের বিবরণ অনুযায়ী যেকোনও একটি এন্ডপয়েন্ট ব্যবহার করতে হবে।
  3. পরিষেবার অ্যাকাউন্টের অ্যাক্সেস টোকেন যোগ করতে হবে।
  4. এপিআই ব্যবহার করা নিবন্ধের বিবরণ অনুযায়ী অনুরোধের বডি লিখতে হবে।

উদাহরণ

OAuth অ্যাক্সেস টোকেন কীভাবে পাওয়া যায় তা নিচের উদাহরণগুলিতে দেওয়া হল:

Python

OAuth টোকেন পেতে Python-এর জন্য Google এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে:

from oauth2client.service_account import ServiceAccountCredentials
import httplib2

SCOPES = [ "https://www.googleapis.com/auth/indexing" ]
ENDPOINT = "https://indexing.googleapis.com/v3/urlNotifications:publish"

# service_account_file.json is the private key that you created for your service account.
JSON_KEY_FILE = "service_account_file.json"

credentials = ServiceAccountCredentials.from_json_keyfile_name(JSON_KEY_FILE, scopes=SCOPES)

http = credentials.authorize(httplib2.Http())

# Define contents here as a JSON string.
# This example shows a simple update request.
# Other types of requests are described in the next step.

content = """{
  \"url\": \"http://example.com/jobs/42\",
  \"type\": \"URL_UPDATED\"
}"""

response, content = http.request(ENDPOINT, method="POST", body=content)

Java

OAuth টোকেন পেতে Java জন্য এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে:

String scopes = "https://www.googleapis.com/auth/indexing";
String endPoint = "https://indexing.googleapis.com/v3/urlNotifications:publish";

JsonFactory jsonFactory = new JacksonFactory();

// service_account_file.json is the private key that you created for your service account.
InputStream in = IOUtils.toInputStream("service_account_file.json");

GoogleCredential credentials =
  GoogleCredential.fromStream(in, this.httpTransport, jsonFactory).createScoped(Collections.singleton(scopes));

GenericUrl genericUrl = new GenericUrl(endPoint);
HttpRequestFactory requestFactory = this.httpTransport.createRequestFactory();

// Define content here. The structure of the content is described in the next step.
String content = "{"
  + "\"url\": \"http://example.com/jobs/42\","
  + "\"type\": \"URL_UPDATED\","
  + "}";

HttpRequest request =
  requestFactory.buildPostRequest(genericUrl, ByteArrayContent.fromString("application/json", content));

credentials.initialize(request);
HttpResponse response = request.execute();
int statusCode = response.getStatusCode();

PHP

OAuth টোকেন পেতে PHP-এর জন্য এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে:

require_once 'google-api-php-client/vendor/autoload.php';

$client = new Google_Client();

// service_account_file.json is the private key that you created for your service account.
$client->setAuthConfig('service_account_file.json');
$client->addScope('https://www.googleapis.com/auth/indexing');

// Get a Guzzle HTTP Client
$httpClient = $client->authorize();
$endpoint = 'https://indexing.googleapis.com/v3/urlNotifications:publish';

// Define contents here. The structure of the content is described in the next step.
$content = '{
  "url": "http://example.com/jobs/42",
  "type": "URL_UPDATED"
}';

$response = $httpClient->post($endpoint, [ 'body' => $content ]);
$status_code = $response->getStatusCode();

Node.js

OAuth টোকেন পেতে Node.js-এর জন্য ক্লায়েন্ট লাইব্রেরি ব্যবহার করে:

var request = require("request");
var google = require("googleapis");
var key = require("./service_account.json");

const jwtClient = new google.auth.JWT(
  key.client_email,
  null,
  key.private_key,
  ["https://www.googleapis.com/auth/indexing"],
  null
);

jwtClient.authorize(function(err, tokens) {
  if (err) {
    console.log(err);
    return;
  }
  let options = {
    url: "https://indexing.googleapis.com/v3/urlNotifications:publish",
    method: "POST",
    // Your options, which must include the Content-Type and auth headers
    headers: {
      "Content-Type": "application/json"
    },
    auth: { "bearer": tokens.access_token },
    // Define contents here. The structure of the content is described in the next step.
    json: {
      "url": "http://example.com/jobs/42",
      "type": "URL_UPDATED"
    }
  };
  request(options, function (error, response, body) {
    // Handle the response
    console.log(body);
  });
});

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