এই দস্তাবেজটি বর্ণনা করে যে কীভাবে 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 এবং সিনট্যাক্স |
---|---|---|
তালিকা | প্রমাণীকৃত ব্যবহারকারীর সংগ্রহের মধ্যে সমস্ত সংস্থান তালিকাভুক্ত করে। | উদাহরণ তালিকা অনুরোধ দেখুন. |
সন্নিবেশ | একটি সাইট বা ডোমেন যাচাই করে। সফল হলে, ব্যবহারকারীর সংগ্রহে একটি নতুন ওয়েব সংস্থান সন্নিবেশ করান। রিকোয়েস্ট বডি: ওয়েব রিসোর্স দেখুন। ক্যোয়ারী প্যারামিটার: | উদাহরণ সন্নিবেশ অনুরোধ দেখুন. |
পাওয়া | একটি নির্দিষ্ট ওয়েব সম্পদের জন্য সর্বশেষ ডেটা পায়। | অনুরোধ পেতে উদাহরণ দেখুন |
হালনাগাদ | একটি নির্দিষ্ট সম্পদের জন্য মালিকদের তালিকা পরিবর্তন করে। রিকোয়েস্ট বডি: ওয়েব রিসোর্স দেখুন। মন্তব্য:
| উদাহরণ আপডেট অনুরোধ দেখুন. |
মুছে ফেলা | ব্যবহারকারীর সংগ্রহ থেকে একটি সংস্থান সরিয়ে দেয় (সাইটটি ব্যবহারকারীর অন্তর্গত তা যাচাই করে)।
| উদাহরণ মুছে ফেলার অনুরোধ দেখুন। |
getToken | প্রমাণীকৃত ব্যবহারকারীর ওয়েবসাইটে স্থাপন করার জন্য যাচাইকরণ টোকেন পায়। অনুরোধ বডি:
| উদাহরণ getToken অনুরোধ দেখুন। |
উদাহরণ API কল
এই বিভাগটি অনুমান করে যে আপনি (ডেভেলপার)ও প্রমাণীকৃত ব্যবহারকারী, যেমনটি হবে যখন আপনি প্রথমবার নিজের পরীক্ষার ডেটা দিয়ে API ব্যবহার করে দেখুন।
একটি নতুন সাইট যাচাই করুন
একটি সাইট যাচাই করতে,
- প্রথমে getToken কল করে একটি যাচাইকরণ টোকেনের অনুরোধ করুন।
- আপনি যে পদ্ধতি বেছে নিন তা ব্যবহার করে আপনার সাইটে টোকেন রাখুন।
- সন্নিবেশ অপারেশন ব্যবহার করে সাইটটি আপনার কিনা তা যাচাই করতে 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 (কোন বিষয়বস্তু নেই) স্ট্যাটাস কোড, সাফল্য নির্দেশ করে।