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 khusus 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 pada kueri. Parameter sebenarnya yang Anda gunakan bervariasi bergantung pada operasi yang Anda jalankan. 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 informasi selengkapnya, lihat json.org.

Ringkasan operasi

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

Operasi Deskripsi URL dan sintaksis
list

Mencantumkan semua resource dalam koleksi pengguna terautentikasi.

GET /webResource

Lihat contoh permintaan daftar.

sisipkan

Memverifikasi situs atau domain. Jika berhasil, referensi web baru akan disisipkan ke dalam koleksi pengguna.

Isi permintaan: Lihat Referensi 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 sisipkan.

dapatkan

Mendapatkan data terbaru untuk resource web tertentu.

GET /webResource/resourceID

Lihat contoh permintaan get

info terbaru

Memodifikasi daftar pemilik untuk resource tertentu.

Isi permintaan: Lihat Referensi 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 (tidak memverifikasi bahwa situs tersebut adalah milik pengguna).

Catatan:

  • Anda harus menghapus semua token verifikasi pengguna yang diautentikasi dari situs atau domain terlebih dahulu sebelum memanggil delete. Jika token masih ada, error HTTP 400 (Permintaan Buruk) akan ditampilkan.
  • Penghapusan hanya akan memengaruhi data kepemilikan untuk pengguna yang diautentikasi. Semua pengguna lain, baik yang didelegasikan maupun diverifikasi secara independen, tetap memiliki kepemilikan setelah penghapusan.

DELETE /webResource/resourceID

Lihat contoh permintaan hapus.

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 Anda. 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,

  1. Pertama-tama, minta token verifikasi dengan memanggil getToken.
  2. Tempatkan token di situs Anda menggunakan metode apa pun yang Anda pilih.
  3. Minta Google untuk memverifikasi bahwa situs tersebut milik Anda, menggunakan operasi insert.

getToken (membutuhkan 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"
}

Masukkan (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 referensi 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"
      }
    }
  ]
}

Dapatkan (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 delete.

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 (Tidak Ada Konten), yang menunjukkan keberhasilan.