Bu dokümanda, Google Site Doğrulama API'sinin nasıl kullanılacağı açıklanmaktadır.
API çağırma
İstek biçimi
Desteklenen Site Doğrulama işlemlerinin çoğu, Google Site Doğrulama API işlemlerinde açıklandığı gibi, doğrudan REST HTTP fiilleriyle (GET
, POST
, PUT
, DELETE
) eşlenir.
Google Site Doğrulama API URI'ları için belirli biçim şöyledir:
https://www.googleapis.com/siteVerification/v1/webResource/resourceID?parameters
resourceID
, web kaynağının tanımlayıcısıdır. parameters
ise sorguya uygulanacak tüm parametrelerdir. Kullandığınız gerçek parametreler, gerçekleştirdiğiniz işleme bağlı olarak değişiklik gösterir. Ayrıca, OAuth 2.0 kullanıyorsanız bu parametrelerde access_token
değerini ayarlamanız gerekir.
Liste sorguları için bir resourceID gerekmez. Bu nedenle, biçim şu şekildedir:
https://www.googleapis.com/siteVerification/v1/webResource?parameters
getToken işlemine kendi benzersiz URI'si ile çağrı yapabilirsiniz. getToken çağrısının biçimi şöyledir:
https://www.googleapis.com/siteVerification/v1/token?parameters
Veri biçimi
Google Site Doğrulama API'si, verileri JSON biçiminde döndürür.
JSON (JavaScript Object Notation), rastgele veri yapılarının basit metin temsilini sağlayan yaygın, dilden bağımsız bir veri biçimidir. Daha fazla bilgi için json.org adresine bakın.
İşlemler özeti
Aşağıdaki tabloda açıklandığı gibi, Google Site Doğrulama API'sinde koleksiyonlar ve kaynaklar için altı farklı yöntem çağırabilirsiniz. API URL'leri https://www.googleapis.com/siteVerification/v1
ile ilgilidir.
İşlem | Açıklama | URL ve söz dizimi |
---|---|---|
list | Kimliği doğrulanmış kullanıcının koleksiyonundaki tüm kaynakları listeler. |
Örnek listrequest bölümüne bakın. |
ekle | Bir siteyi veya alanı doğrular. Başarılı olursa kullanıcının koleksiyonuna yeni bir web kaynağı ekler. İstek metni: Web Kaynağı'na bakın. Sorgu parametresi: |
Örnek insert isteğine bakın. |
al | Belirli bir web kaynağı için en son verileri alır. |
Örnek alın isteğini inceleyin |
güncelle | Belirli bir kaynak için sahip listesini değiştirir. İstek metni: Web Kaynağı'na bakın. Notlar:
|
Örnek güncelleme isteğine göz atın. |
sil | Kaynağı kullanıcının koleksiyonundan kaldırır (sitenin kullanıcıya ait olduğunu belirtir).
|
Örnek silme isteğine bakın. |
getToken | Kimliği doğrulanmış kullanıcının web sitesine yerleştirilebilecek doğrulama jetonunu alır. İstek metni:
|
Örnek getToken isteğine bakın. |
Örnek API çağrıları
Bu bölümde, sizin (geliştirici) API'yi kendi test verilerinizle ilk denediğinizde olduğu gibi sizin de kimliği doğrulanmış kullanıcı olduğunuz varsayılır.
Yeni bir siteyi doğrulama
Bir siteyi doğrulamak için
- Öncelikle getToken adresini arayarak bir doğrulama jetonu isteyin.
- Seçtiğiniz yöntemi kullanarak jetonu sitenize yerleştirin.
- Google'dan, ekle işlemini kullanarak sitenin size ait olduğunu doğrulamasını isteyin.
getToken (yetkilendirme gerektirir)
POST https://www.googleapis.com/siteVerification/v1/token?access_token=
oauth2-token
İstek:
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"
}
}
Yanıt:
{ "token": "google12cfc68677988bb4.html", "method": "FILE" }
Ekle (yetkilendirme gerekir)
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=
oauth2-token
İstek:
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"
}
}
Yanıt:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Doğrulanmış web kaynakları için bilgi alma
Listeyi arayarak doğrulanmış sitelerinizin ve alanlarınızın tam listesini alabilirsiniz. get yöntemini çağırarak tek bir web kaynağı için bilgileri alabilirsiniz.
Liste (yetkilendirme gerektirir)
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=
oauth2-token
İstek:
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=oauth2-token
Yanıt:
{ "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" } } ] }
Al (yetkilendirme gerekir)
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
İstek:
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Yanıt:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Doğrulama bilgilerini değiştirme
Güncelle'yi arayarak sahiplik yetkisi verebilir ve sahipliği iptal edebilirsiniz. Sil çağrısını yaparak sahipliği kendiniz için kaldırabilirsiniz.
Güncelleme (yetkilendirme gerekir)
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
İstek:
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"
}
}
Yanıt:
{ "owners": [ "myself@example.com", "another@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Sil (yetkilendirme gerekir)
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
İstek:
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Yanıt:
Başarılı olduğunu gösteren HTTP 204 (İçerik Yok) durum kodu.