Halaman ini diterjemahkan oleh Cloud Translation API.

Memanggil API

Dokumen ini menjelaskan cara menggunakan Google Site Verification API.

Memanggil API

Format permintaan

Sebagian besar operasi Verifikasi Situs yang didukung dipetakan langsung ke kata kerja HTTP REST (GET, POST, PUT, DELETE), seperti yang dijelaskan dalam Operasi Google Site Verification API.

Format spesifik untuk URI Google Site Verification API adalah:

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

dengan resourceID adalah ID untuk resource web, parameters adalah parameter apa pun yang akan diterapkan ke kueri. Parameter aktual yang Anda gunakan bervariasi bergantung pada operasi yang Anda lakukan. Selain itu, jika menggunakan OAuth 2.0, Anda harus menetapkan access_token dalam parameter ini.

Kueri daftar tidak memerlukan resourceID, sehingga formatnya adalah:

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

Anda dapat melakukan panggilan ke operasi getToken dengan URI uniknya sendiri. Format panggilan ke getToken adalah:

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

Format data

Google Site Verification API menampilkan data dalam format JSON.

JSON (JavaScript Object Notation) adalah format data umum independen bahasa yang memberikan representasi teks sederhana untuk struktur data arbitrer. Untuk mendapatkan informasi lebih lanjut, lihat json.org.

Ringkasan operasi

Anda dapat memanggil enam metode yang berbeda pada koleksi dan resource di Google Site Verification API, seperti yang dijelaskan dalam tabel berikut. URL API relatif terhadap https://www.googleapis.com/siteVerification/v1.

Operasi	Deskripsi	URL dan sintaksis
list	Mencantumkan semua fasilitas dalam koleksi pengguna yang diautentikasi.	`GET /webResource` Lihat contoh permintaan daftar.
masukkan	Memverifikasi situs atau domain. Jika berhasil, masukkan resource web baru ke dalam koleksi pengguna. Isi permintaan: Lihat Resource Web. Parameter kueri: `verificationMethod`. Metode verifikasi yang akan digunakan untuk permintaan ini. Nilai yang mungkin: `FILE`, `META`, `ANALYTICS`, `TAG_MANAGER`, `DNS_TXT`, `DNS_CNAME`	`POST /webResource` Lihat contoh permintaan insert.
dapatkan	Mendapatkan data terbaru untuk resource web tertentu.	`GET /webResource/resourceID` Lihat contoh permintaan get
perbarui	Mengubah daftar pemilik untuk resource tertentu. Isi permintaan: Lihat Resource Web. Catatan: Anda tidak dapat menghapus pengguna terautentikasi dari daftar pemilik menggunakan update. Sebagai gantinya, gunakan delete. Anda dapat menghapus setiap pengguna yang tidak memiliki token verifikasi di situs dari daftar pemilik.	`PUT /webResource/resourceID` Lihat contoh permintaan update.
hapus	Menghapus resource dari koleksi pengguna (menunjukkan bahwa situs tersebut milik pengguna). Catatan: Anda harus menghapus semua token verifikasi pengguna yang diautentikasi terlebih dahulu dari situs atau domain sebelum memanggil delete. Jika ada token yang masih ada, error HTTP 400 (Permintaan Buruk) akan ditampilkan. Penghapusan hanya memengaruhi data kepemilikan untuk pengguna terautentikasi. Semua pengguna lain, baik yang didelegasikan maupun diverifikasi secara independen, tetap memiliki kepemilikan setelah penghapusan.	`DELETE /webResource/resourceID` Lihat contoh permintaan delete.
getToken	Mendapatkan token verifikasi untuk ditempatkan di situs pengguna yang diautentikasi. Isi permintaan: `identifier`: URL situs atau nama domain. `type`: Jenis resource yang akan diverifikasi. Nilai yang mungkin: `SITE`, `INET_DOMAIN`. `verificationMethod`: Metode yang digunakan saat memverifikasi situs. Nilai yang mungkin: `FILE`, `META`, `ANALYTICS`, `TAG_MANAGER`, `DNS_TXT`, `DNS_CNAME`	`POST /token` Lihat contoh permintaan getToken.

Contoh panggilan API

Bagian ini mengasumsikan bahwa Anda (developer) juga merupakan pengguna terautentikasi, seperti yang akan terjadi saat Anda pertama kali mencoba API dengan data pengujian Anda sendiri.

Verifikasi situs baru

Untuk memverifikasi situs,

Minta token verifikasi terlebih dahulu dengan memanggil getToken.
Tempatkan token di situs Anda menggunakan metode apa pun yang Anda pilih.
Minta Google untuk memverifikasi bahwa situs tersebut adalah milik Anda, dengan menggunakan operasi insert.

getToken (memerlukan otorisasi)

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

Permintaan:

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"
  }
}

Respons:

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

Sisipkan (memerlukan otorisasi)

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

Permintaan:

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"
  }
}

Respons:

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

Mengambil informasi untuk resource web terverifikasi

Anda dapat mengambil daftar lengkap situs dan domain terverifikasi dengan memanggil list. Anda dapat mengambil informasi untuk satu resource web dengan memanggil get.

Daftar (memerlukan otorisasi)

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

Permintaan:

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

Respons:

{
  "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 (memerlukan otorisasi)

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

Permintaan:

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

Respons:

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

Mengubah informasi verifikasi

Anda dapat mendelegasikan dan mencabut kepemilikan dengan memanggil update. Anda dapat menghapus kepemilikan untuk diri sendiri dengan memanggil hapus.

Update (memerlukan otorisasi)

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

Permintaan:

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"
  }
}

Respons:

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

Hapus (memerlukan otorisasi)

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

Permintaan:

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

Respons:

Kode status HTTP 204 (Tanpa Konten), yang menunjukkan keberhasilan.