এপিআই আহ্বান করা হচ্ছে

এই দস্তাবেজটি বর্ণনা করে যে কীভাবে Google সাইট যাচাইকরণ API ব্যবহার করতে হয়।

এপিআই আহ্বান করা হচ্ছে

বিন্যাস অনুরোধ

বেশিরভাগ সমর্থিত সাইট যাচাইকরণ ক্রিয়াকলাপগুলি সরাসরি REST HTTP ক্রিয়াপদের সাথে ম্যাপ করে ( GET , POST , PUT , DELETE ), যেমনটি Google Site Verification API অপারেশনগুলিতে বর্ণিত হয়েছে৷

Google সাইট যাচাইকরণ API URI-এর জন্য নির্দিষ্ট বিন্যাস হল:

https://www.googleapis.com/siteVerification/v1/webResource/resourceID?parameters

যেখানে রিসোর্সআইডি একটি ওয়েব resourceID শনাক্তকারী, সেখানে parameters হল যেকোন প্যারামিটার যা ক্যোয়ারীতে প্রযোজ্য। আপনি কোন অপারেশন করছেন তার উপর নির্ভর করে আপনার ব্যবহার করা প্রকৃত পরামিতি পরিবর্তিত হয়। অতিরিক্তভাবে, আপনি যদি OAuth 2.0 ব্যবহার করেন, তাহলে এই প্যারামিটারগুলিতে আপনার access_token সেট করা উচিত।

তালিকা প্রশ্নগুলির জন্য একটি resourceID প্রয়োজন হয় না, তাই বিন্যাসটি হল:

https://www.googleapis.com/siteVerification/v1/webResource?parameters

আপনি তার নিজস্ব অনন্য URI দ্বারা getToken অপারেশনে কল করতে পারেন। GetToken- এ কলের বিন্যাস হল:

https://www.googleapis.com/siteVerification/v1/token?parameters

উপাত্ত বিন্যাস

Google সাইট যাচাইকরণ API JSON ফর্ম্যাটে ডেটা প্রদান করে।

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

অপারেশন সারাংশ

আপনি Google সাইট যাচাইকরণ API-এ সংগ্রহ এবং সংস্থানগুলির জন্য ছয়টি ভিন্ন পদ্ধতি ব্যবহার করতে পারেন, যেমনটি নিম্নলিখিত টেবিলে বর্ণিত হয়েছে। API URLগুলি https://www.googleapis.com/siteVerification/v1 এর সাথে সম্পর্কিত।

অপারেশন বর্ণনা URL এবং সিনট্যাক্স
তালিকা

প্রমাণীকৃত ব্যবহারকারীর সংগ্রহের মধ্যে সমস্ত সংস্থান তালিকাভুক্ত করে।

GET /webResource

উদাহরণ তালিকা অনুরোধ দেখুন.

সন্নিবেশ

একটি সাইট বা ডোমেন যাচাই করে। সফল হলে, ব্যবহারকারীর সংগ্রহে একটি নতুন ওয়েব সংস্থান সন্নিবেশ করান।

রিকোয়েস্ট বডি: ওয়েব রিসোর্স দেখুন।

ক্যোয়ারী প্যারামিটার: verificationMethod পদ্ধতি। এই অনুরোধের জন্য ব্যবহার করার জন্য যাচাই পদ্ধতি । সম্ভাব্য মান: FILE , META , ANALYTICS , TAG_MANAGER , DNS_TXT , DNS_CNAME

POST /webResource

উদাহরণ সন্নিবেশ অনুরোধ দেখুন.

পাওয়া

একটি নির্দিষ্ট ওয়েব সম্পদের জন্য সর্বশেষ ডেটা পায়।

GET /webResource/ resourceID

অনুরোধ পেতে উদাহরণ দেখুন

হালনাগাদ

একটি নির্দিষ্ট সম্পদের জন্য মালিকদের তালিকা পরিবর্তন করে।

রিকোয়েস্ট বডি: ওয়েব রিসোর্স দেখুন।

মন্তব্য:

  • আপনি আপডেট ব্যবহার করে মালিকদের তালিকা থেকে প্রমাণীকৃত ব্যবহারকারীকে সরাতে পারবেন না। পরিবর্তে মুছে ফেলুন ব্যবহার করুন.
  • আপনি মালিকদের তালিকা থেকে এমন যেকোন ব্যবহারকারীকে সরিয়ে দিতে পারেন যার সাইটে কোনো যাচাইকরণ টোকেন নেই।

PUT /webResource/ resourceID

উদাহরণ আপডেট অনুরোধ দেখুন.

মুছে ফেলা

ব্যবহারকারীর সংগ্রহ থেকে একটি সংস্থান সরিয়ে দেয় (সাইটটি ব্যবহারকারীর অন্তর্গত তা যাচাই করে)।

মন্তব্য:

  • মুছে ফেলতে কল করার আগে আপনাকে অবশ্যই সাইট বা ডোমেন থেকে সমস্ত প্রমাণীকৃত ব্যবহারকারীর যাচাইকরণ টোকেন সরিয়ে ফেলতে হবে। কোনো টোকেন এখনও বিদ্যমান থাকলে, একটি HTTP 400 (খারাপ অনুরোধ) ত্রুটি ফেরত দেওয়া হয়।
  • মুছে ফেলা শুধুমাত্র প্রমাণীকৃত ব্যবহারকারীর জন্য মালিকানা ডেটা প্রভাবিত করে। অন্য সমস্ত ব্যবহারকারী, তারা অর্পিত বা স্বাধীনভাবে যাচাই করা হোক না কেন, মুছে ফেলার পরে মালিকানা বজায় রাখে।

DELETE /webResource/ resourceID

উদাহরণ মুছে ফেলার অনুরোধ দেখুন।

getToken

প্রমাণীকৃত ব্যবহারকারীর ওয়েবসাইটে স্থাপন করার জন্য যাচাইকরণ টোকেন পায়।

অনুরোধ বডি:

  • identifier : সাইটের URL বা ডোমেন নাম।
  • type : যাচাই করার জন্য সম্পদের ধরন। সম্ভাব্য মান: SITE , INET_DOMAIN ।
  • verificationMethod পদ্ধতি: আপনার সাইট যাচাই করার সময় ব্যবহার করার পদ্ধতি। সম্ভাব্য মান: FILE , META , ANALYTICS , TAG_MANAGER , DNS_TXT , DNS_CNAME

POST /token

উদাহরণ getToken অনুরোধ দেখুন।

উদাহরণ API কল

এই বিভাগটি অনুমান করে যে আপনি (ডেভেলপার)ও প্রমাণীকৃত ব্যবহারকারী, যেমনটি হবে যখন আপনি প্রথমবার নিজের পরীক্ষার ডেটা দিয়ে API ব্যবহার করে দেখুন।

একটি নতুন সাইট যাচাই করুন

একটি সাইট যাচাই করতে,

  1. প্রথমে getToken কল করে একটি যাচাইকরণ টোকেনের অনুরোধ করুন।
  2. আপনি যে পদ্ধতি বেছে নিন তা ব্যবহার করে আপনার সাইটে টোকেন রাখুন।
  3. সন্নিবেশ অপারেশন ব্যবহার করে সাইটটি আপনার কিনা তা যাচাই করতে Google-কে বলুন।

getToken ( অনুমোদন প্রয়োজন )

POST https://www.googleapis.com/siteVerification/v1/token?access_token= oauth2-token

অনুরোধ:

POST https://www.googleapis.com/siteVerification/v1/token?access_token=oauth2-token
Content-Type: application/json

{
  "verificationMethod": "FILE",
  "site": {
    "identifier": "http://www.example.com",
    "type": "SITE"
  }
}

প্রতিক্রিয়া:

{
  "token": "google12cfc68677988bb4.html",
  "method": "FILE"
}

সন্নিবেশ ( অনুমোদন প্রয়োজন )

POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token= oauth2-token

অনুরোধ:

POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=oauth2-token
Content-Type: application/json

{
  "site": {
    "identifier": "http://www.example.com",
    "type": "SITE"
  }
}

প্রতিক্রিয়া:

{
  "owners": [
    "myself@example.com",
  ],
  "id": "http%3A%2F%2Fwww.example.com%2F",
  "site": {
    "identifier": "http://www.example.com/",
    "type": "SITE"
  }
}

যাচাইকৃত ওয়েব সংস্থানগুলির জন্য তথ্য পুনরুদ্ধার করুন

আপনি কলিং তালিকার মাধ্যমে আপনার যাচাইকৃত সাইট এবং ডোমেনের সম্পূর্ণ তালিকা পুনরুদ্ধার করতে পারেন। আপনি get কল করে একটি একক ওয়েব রিসোর্সের জন্য তথ্য পুনরুদ্ধার করতে পারেন।

তালিকা ( অনুমোদন প্রয়োজন )

GET https://www.googleapis.com/siteVerification/v1/webResource?access_token= oauth2-token

অনুরোধ:

GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=oauth2-token

প্রতিক্রিয়া:

{
  "items": [
    {
      "owners": [
        "myself@example.com",
      ],
      "id": "http%3A%2F%2Fwww.example.com%2F",
      "site": {
        "identifier": "http://www.example.com/site1",
        "type": "SITE"
      }
    },
    {
      "owners": [
        "myself@example.com",
      ],
      "id": "http%3A%2F%2Fwww.example.com%2F",
      "site": {
        "identifier": "http://www.example.com/site2",
        "type": "SITE"
      }
    }
  ]
}

পান ( অনুমোদন প্রয়োজন )

GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token= oauth2-token

অনুরোধ:

GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token

প্রতিক্রিয়া:

{
  "owners": [
    "myself@example.com",
  ],
  "id": "http%3A%2F%2Fwww.example.com%2F",
  "site": {
    "identifier": "http://www.example.com/",
    "type": "SITE"
  }
}

যাচাইকরণের তথ্য পরিবর্তন করুন

আপনি আপডেট কল করে মালিকানা অর্পণ এবং প্রত্যাহার করতে পারেন৷ আপনি ডিলিট কল করে নিজের জন্য মালিকানা সরাতে পারেন।

আপডেট ( অনুমোদন প্রয়োজন )

PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token= oauth2-token

অনুরোধ:

PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Content-Type: application/json

{
  "owners": [
    "myself@example.com",
    "another@example.com",
  ],
  "id": "http%3A%2F%2Fwww.example.com%2F",
  "site": {
    "identifier": "http://www.example.com",
    "type": "SITE"
  }
}

প্রতিক্রিয়া:

{
  "owners": [
    "myself@example.com",
    "another@example.com",
  ],
  "id": "http%3A%2F%2Fwww.example.com%2F",
  "site": {
    "identifier": "http://www.example.com/",
    "type": "SITE"
  }
}

মুছুন ( অনুমোদন প্রয়োজন )

DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token= oauth2-token

অনুরোধ:

DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token

প্রতিক্রিয়া:

HTTP 204 (কোন বিষয়বস্তু নেই) স্ট্যাটাস কোড, সাফল্য নির্দেশ করে।