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

এক নজরে

ইন্ডেক্সিং এপিআই ব্যবহার করে আপনি Google ইন্ডেক্সে কোনও পৃষ্ঠা আপডেট করা বা সেখান থেকে সরিয়ে ফেলার কথা Google-কে জানাতে পারেন। অনুরোধে, ওয়েব পৃষ্ঠার নির্দিষ্ট লোকেশন উল্লেখ করা থাকতে হবে। Google-এ পাঠানো বিজ্ঞপ্তির স্ট্যাটাস সম্পর্কেও আপনি জানতে পারেন। বর্তমানে, শুধু লাইভস্ট্রিমচাকরির পোস্টিং সংক্রান্ত স্ট্রাকচার্ড ডেটা আছে এমন পৃষ্ঠা ক্রল করার জন্য ইন্ডেক্সিং এপিআই ব্যবহার করা যেতে পারে।

ইন্ডেক্সিং এপিআইয়ে অনুরোধ পাঠানোর সময় কোনও স্বতন্ত্র ওয়েব পৃষ্ঠা ক্রল করা বা ইন্ডেক্স থেকে সরিয়ে ফেলার কথা Google-কে জানাতে সেটির লোকেশন উল্লেখ করুন।

ইন্ডেক্সিং এপিআই ব্যবহার করে আপনি যা করতে পারেন তা এই উদাহরণগুলি থেকে দেখুন:

ইউআরএল আপডেট করা

POST https://indexing.googleapis.com/v3/urlNotifications:publish
{
  "url": "https://careers.google.com/jobs/google/technical-writer",
  "type": "URL_UPDATED"
}
ইউআরএল সরানো

POST https://indexing.googleapis.com/v3/urlNotifications:publish
{
  "url": "https://careers.google.com/jobs/google/technical-writer",
  "type": "URL_DELETED"
}
বিজ্ঞপ্তির স্ট্যাটাস পাওয়া

GET https://indexing.googleapis.com/v3/urlNotifications/metadata

প্যারামিটার

সব পদ্ধতির (ইউআরএল আপডেট করা বা সরানো) জন্যই প্রয়োজনীয় ফিল্ডগুলির বিবরণ নিচের সারণীতে দেওয়া হল:

ফিল্ড
url

প্রয়োজনীয়

আপনি আপডেট করতে বা সরাতে চান এমন আইটেমের সঠিক লোকেশন।

type

প্রয়োজনীয়

আপনি যে বিজ্ঞপ্তি জমা দিয়েছেন সেটির ধরন।

নির্দেশিকা

ইউআরএল আপডেট করা বা সরানোর অনুরোধের ক্ষেত্রে নিম্নলিখিত নির্দেশিকা প্রযোজ্য হয়।

  • https://indexing.googleapis.com/v3/UrlNotifications:publish-এ যেসব কল করা হচ্ছে সেগুলির ক্ষেত্রে "application/json"-কে অবশ্যই Content-Type হেডার হিসেবে ব্যবহার করতে হবে।
  • আপডেট করার অনুরোধের বডিতে আপনি শুধু একটি ইউআরএল লিখতে পারেন অথবা ব্যাচ ইন্ডেক্সিংয়ের অনুরোধ পাঠানো অনুযায়ী ১০০টি পর্যন্ত অনুরোধকে একটি ব্যাচে সম্মিলিত করতে পারেন।
  • এই উদাহরণগুলিতে প্রদত্ত অনুরোধের বডি হল অ্যাক্সেস টোকেনের উদাহরণ-এ ব্যবহৃত content ভেরিয়েবলের মান।

ইউআরএল আপডেট করা

Google-কে একটি নতুন ইউআরএল ক্রল করতে বলা বা আগে জমা দেওয়া হয়েছিল এমন কোনও ইউআরএলে কন্টেন্ট আপডেট হয়েছে বলে জানানোর জন্য আপনি নিচের ধাপগুলি অনুসরণ করুন:

  1. নিচে লেখা এন্ডপয়েন্টে POST অনুরোধ জমা দিন:
    POST https://indexing.googleapis.com/v3/urlNotifications:publish
  2. অনুরোধের বডিতে নিচের সিন্ট্যাক্স ব্যবহার করে পৃষ্ঠার লোকেশন লিখুন:
    {
      "url": "content_location",
      "type": "URL_UPDATED"
    }
  3. ইন্ডেক্সিং এপিআই কল সফল হলে, Google HTTP 200-এর মাধ্যমে প্রতিক্রিয়া জানায়। Google যে শীঘ্রই এই ইউআরএল আবার ক্রল করার চেষ্টা করতে পারে তা HTTP 200-এর মাধ্যমে বোঝা যায়। প্রতিক্রিয়ার বডিতে যে UrlNotificationMetadata অবজেক্ট থাকে সেটির ফিল্ডগুলি বিজ্ঞপ্তির স্ট্যাটাসের অনুরোধ-এর পাঠানো প্রতিক্রিয়ার সাথে সম্পর্কযুক্ত হয়।
  4. আপনি HTTP 200 প্রতিক্রিয়া না পেলে, ইন্ডেক্সিং এপিআই সংক্রান্ত সমস্যা দেখুন।
  5. পৃষ্ঠায় কিছু পরিবর্তন হলে Google যাতে পৃষ্ঠাটি আবার ক্রল করার চেষ্টা করে, সেই জন্য আরেকটি আপডেট করার বিজ্ঞপ্তি জমা দিন।
  6. আপনার ডিফল্টের থেকে বেশি কোটা প্রয়োজন হতে পারে। আপনার বর্তমান কোটা কত তা জানতে এবং আরও বেশি কোটার অনুরোধ করতে, কোটা দেখুন।

ইউআরএল সরানো

আপনার সার্ভার থেকে কোনও পৃষ্ঠা মুছে ফেললে তা Google-কে জানাতে পারেন। এর ফলে, আমাদের ইন্ডেক্স থেকে আমরা সেটিকে সরিয়ে দিতে পারি এবং সেই ইউআরএল আবার ক্রল করার চেষ্টা করি না। সরানোর অনুরোধ করার আগে, আপনাকে সার্ভার থেকে পৃষ্ঠাটি সরিয়ে ফেলতে হবে এবং ইউআরএলটি 404 বা 410 স্ট্যাটাস কোড পাঠাচ্ছে কিনা দেখে নিতে হবে।

আমাদের ইন্ডেক্স থেকে সরানোর অনুরোধ করতে নিচের ধাপগুলি অনুসরণ করুন:

  1. নিচে লেখা এন্ডপয়েন্টে POST অনুরোধ জমা দিন:
    POST https://indexing.googleapis.com/v3/urlNotifications:publish
  2. অনুরোধের বডিতে নিচের সিন্ট্যাক্স ব্যবহার করে যে ইউআরএল সরাতে চান সেটি লিখুন:
    {
      "url": "content_location",
      "type": "URL_DELETED"
    }

    যেমন:

    {
      "url": "https://careers.google.com/jobs/google/technical-writer",
      "type": "URL_DELETED"
    }
  3. ইন্ডেক্সিং এপিআই কল সফল হলে, Google HTTP 200-এর মাধ্যমে প্রতিক্রিয়া জানায়। Google যে শীঘ্রই এই ইউআরএল আবার ক্রল করার চেষ্টা করতে পারে তা HTTP 200-এর মাধ্যমে বোঝা যায়। প্রতিক্রিয়ার বডিতে যে UrlNotificationMetadata অবজেক্ট থাকে সেটির ফিল্ডগুলি বিজ্ঞপ্তির স্ট্যাটাসের অনুরোধ-এর পাঠানো প্রতিক্রিয়ার সাথে সম্পর্কযুক্ত হয়।
  4. আপনি HTTP 200 প্রতিক্রিয়া না পেলে, ইন্ডেক্সিং এপিআই সংক্রান্ত সমস্যা দেখুন।
  5. আপনার ডিফল্টের থেকে বেশি কোটা প্রয়োজন হতে পারে। আপনার বর্তমান কোটা কত তা জানতে এবং আরও বেশি কোটার অনুরোধ করতে, কোটা দেখুন।

বিজ্ঞপ্তির স্ট্যাটাস পাওয়া

ইন্ডেক্সিং এপিআই ব্যবহার করে একটি বিশেষ ইউআরএল সম্পর্কে প্রযোজ্য সব ধরনের বিজ্ঞপ্তি Google শেষবার কখন পেয়েছিল তা জানতে পারেন। Google কখন একটি ইউআরএল ইন্ডেক্স করবে বা সরিয়ে দেবে তা GET অনুরোধ থেকে জানা যায় না; শুধু আপনার অনুরোধ সফলভাবে জমা হয়েছে কিনা তা আপনি এর মাধ্যমে জানতে পারেন।

বিজ্ঞপ্তির স্ট্যাটাস পেতে নিচের ধাপগুলি অনুসরণ করুন:

  1. নিচে লেখা এন্ডপয়েন্টে GET অনুরোধ জমা দিন: আপনাকে ইউআরএল অবশ্যই ইউআরএল হিসেবে এনকোড করে লিখতে হবে। যেমন : (কোলন) ও / (ফরওয়ার্ড স্ল্যাশ) যথাক্রমে %3A%2F দিয়ে প্রতিস্থাপিত করতে হবে।
    GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=url-encoded_url

    যেমন:

    GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fcareers.google.com%2Fjobs%2Fgoogle%2Ftechnical-writer
    
  2. ইন্ডেক্সিং এপিআই HTTP 200 মেসেজের মাধ্যমে বিজ্ঞপ্তিটি সম্পর্কে বিবরণ আছে এমন একটি পেলোড সহ উত্তর দেয়। আপডেট ও মুছে ফেলার বিজ্ঞপ্তি সম্পর্কে তথ্য সহ প্রতিক্রিয়ার বডি নিচের উদাহরণে দেখানো হল:
    {
      url: “http://foo.com“
      latest_update {
        type: “URL_UPDATED”
        notify_time: “2017-07-31T19:30:54.524457662Z”
      }
      latest_remove {
        type: “URL_DELETED”
        notify_time: “2017-08-31T19:30:54.524457662Z”
      }
    }
    
  3. আপনি HTTP 200 প্রতিক্রিয়া না পেলে, ইন্ডেক্সিং এপিআই সংক্রান্ত সমস্যা দেখুন।
  4. আপনার ডিফল্টের থেকে বেশি কোটা প্রয়োজন হতে পারে। আপনার বর্তমান কোটা কত তা জানতে এবং আরও বেশি কোটার অনুরোধ করতে, কোটা দেখুন।

ব্যাচ ইন্ডেক্সিংয়ের অনুরোধ পাঠানো

১০০টি পর্যন্ত কল একটি HTTP অনুরোধে সম্মিলিত করার মাধ্যমে আপনার ক্লায়েন্টকে যতগুলি HTTP কানেকশন করতে হয় তার সংখ্যা কমাতে পারেন।

ইন্ডেক্সিং এপিআইতে ব্যাচ অনুরোধ পাঠানোর সময় নিচে লেখা এন্ডপয়েন্ট ব্যবহার করুন:

https://indexing.googleapis.com/batch

ব্যাচ অনুরোধের বডি একাধিক অংশ নিয়ে তৈরি হয়। নিজস্ব ক্রিয়াপদ, ইউআরএল, হেডার ও বডি নিয়ে তৈরি প্রতিটি অংশও একটি সম্পূর্ণ HTTP অনুরোধ। ব্যাচ অনুরোধের প্রতিটি অংশের সাইজ ১ এমবির থেকে কম হওয়া প্রয়োজন।

যেহেতু Google-এর এপিআই ক্লায়েন্ট লাইব্রেরি অনুযায়ী ব্যাচিং ফাংশন কার্যকরী, তাই ব্যাচ অনুরোধ আপনি সহজে পাঠাতে পারেন। ক্লায়েন্ট লাইব্রেরি ব্যবহার করে ব্যাচ তৈরি করা সম্পর্কে আরও জানতে নিচে উল্লিখিত নির্দিষ্ট প্রোগ্রামিংয়ের ভাষার পৃষ্ঠা দেখুন:

এই পৃষ্ঠায় লেখা ব্যাচ তৈরি করার উদাহরণ ব্যবহার করতে, একটি অ্যাক্সেস টোকেন পাওয়ার বিবরণ অনুযায়ী প্রয়োগ সংক্রান্ত প্রয়োজনীয়তা পূরণ করার জন্য আপনাকে হয়ত কোড আপডেট করতে হবে।

নিম্নলিখিত উদাহরণে, ব্যাচ অনুরোধ মেসেজের বডিতে একটি আপডেট করা ও মুছে ফেলার বিজ্ঞপ্তি অন্তর্ভুক্ত আছে:

POST /batch HTTP/1.1
Host: indexing.googleapis.com
Content-Length: content_length
Content-Type: multipart/mixed; boundary="===============7330845974216740156=="
Authorization: Bearer oauth2_token

--===============7330845974216740156==
Content-Type: application/http
Content-Transfer-Encoding: binary
Content-ID: <b29c5de2-0db4-490b-b421-6a51b598bd22+2>

POST /v3/urlNotifications:publish [1]
Content-Type: application/json
accept: application/json
content-length: 58

{ "url": "http://example.com/jobs/42", "type": "URL_UPDATED" }
--===============7330845974216740156==
Content-Type: application/http
Content-Transfer-Encoding: binary
Content-ID: <b29c5de2-0db4-490b-b421-6a51b598bd22+1>

POST /v3/urlNotifications:publish [2]
Content-Type: application/json
accept: application/json
content-length: 75

{ "url": "http://example.com/widgets/1", "type": "URL_UPDATED" }
--===============7330845974216740156==
Content-Type: application/http
Content-Transfer-Encoding: binary
Content-ID: <b29c5de2-0db4-490b-b421-6a51b598bd22+3>

POST /v3/urlNotifications:publish [3]
Content-Type: application/json
accept: application/json
content-length: 58

{ "url": "http://example.com/jobs/43", "type": "URL_DELETED" }
--===============7330845974216740156==

আরও তথ্যের জন্য ব্যাচ অনুরোধ পাঠানো দেখুন।

Send feedback about...

সার্চ
সার্চ