এপিআই ব্যবহার করা

এক নজরে

ইন্ডেক্সিং এপিআই ব্যবহার করে আপনি 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-এ করা সমস্ত কলের Content-Type হেডার হিসেবে "application/json" অবশ্যই ব্যবহার করতে হবে।
  • আপনার আপডেট করার অনুরোধের মূল অংশে শুধুমাত্র একটি ইউআরএল লিখতে পারবেন অথবা ব্যাচ ইন্ডেক্সিংয়ের অনুরোধ পাঠানোর বর্ণনা অনুযায়ী ১০০টি পর্যন্ত কল একটি ব্যাচে সম্মিলিত করে পাঠাতে পারবেন।
  • এই উদাহরণগুলিতে দেখানো অনুরোধের মূল অংশ হল অ্যাক্সেস টোকেনের উদাহরণে ব্যবহার করা content ভেরিয়েবলের মান।

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

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

  1. নিচে লেখা এন্ডপয়েন্টে POST অনুরোধ জমা দিন:
    POST https://indexing.googleapis.com/v3/urlNotifications:publish
  2. অনুরোধের মূল অংশে পৃষ্ঠার লোকেশন নিচের সিন্ট্যাক্স অনুযায়ী লিখুন:
    {
      "url": "content_location",
      "type": "URL_UPDATED"
    }
  3. Google HTTP 200-এর মাধ্যমে একটি সফল ইন্ডেক্সিং এপিআই কলের উত্তর দেয়। HTTP 200-এর প্রতিক্রিয়া থেকে বোঝা যায় যে Google শীঘ্রই এই ইউআরএল আবার ক্রল করার চেষ্টা করতে পারে। প্রতিক্রিয়ার মূল অংশে একটি 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-এর মাধ্যমে একটি সফল ইন্ডেক্সিং এপিআই কলের উত্তর দেয়। HTTP 200-এর প্রতিক্রিয়া থেকে বোঝা যায় যে Google এই ইউআরএল তার ইন্ডেক্স থেকে সরিয়ে দিতে পারে। প্রতিক্রিয়ার মূল অংশে একটি 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...

সার্চ
সার্চ