Method: ampUrls.batchGet

Menampilkan URL AMP dan URL Cache AMP yang setara.

Permintaan HTTP

POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet

URL menggunakan sintaks anotasi HTTP Google API.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Kolom
urls[]

string

Daftar URL yang akan dicari untuk URL AMP yang disambungkan. URL peka huruf besar/kecil. Hingga 50 URL per pencarian (lihat Batas Penggunaan).

lookupStrategy

enum(LookupStrategy)

lookupStrategy yang diminta.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons URL AMP batch.

Representasi JSON 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Kolom
ampUrls[]

object(AmpUrl)

Untuk setiap URL di BatchAmpUrlsRequest, respons URL. Respons mungkin tidak dalam urutan yang sama seperti URL dalam permintaan batch. Jika BatchAmpUrlsRequest berisi URL duplikat, AmpUrl hanya akan dibuat sekali.

urlErrors[]

object(AmpUrlError)

Error untuk URL yang diminta yang tidak memiliki URL AMP.

Strategi Pencarian

Enumerasi
FETCH_LIVE_DOC Strategi FETCH_LIVE_DOC melibatkan pengambilan dokumen secara langsung dari URL yang tidak ditemukan dalam indeks. Setiap URL permintaan yang tidak ditemukan dalam indeks akan di-crawl secara real time untuk memvalidasi jika ada URL AMP yang sesuai. Strategi ini memiliki cakupan yang lebih tinggi, tetapi dengan latensi tambahan yang diperkenalkan oleh crawling realtime. Ini adalah strategi default. Aplikasi yang menggunakan strategi ini harus menyetel waktu tunggu HTTP yang lebih tinggi untuk panggilan API.
IN_INDEX_DOC Strategi IN_INDEX_DOC melewati pengambilan dokumen aktif URL yang tidak ditemukan dalam indeks. Untuk aplikasi yang memerlukan penggunaan latensi rendah, strategi IN_INDEX_DOC direkomendasikan.

URLAmp

Respons URL AMP untuk URL yang diminta.

Representasi JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Kolom
originalUrl

string

URL non-AMP asli.

ampUrl

string

URL AMP yang mengarah ke server web penayang.

cdnAmpUrl

string

URL Cache AMP yang mengarah ke dokumen yang di-cache di Google AMP Cache.

KesalahanAmpUrl

Resource Error URL AMP untuk URL yang diminta yang tidak dapat ditemukan.

Representasi JSON 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Kolom
errorCode

enum(ErrorCode)

Kode error panggilan API.

errorMessage

string

Pesan error deskriptif opsional.

originalUrl

string

URL non-AMP asli.

ErrorCode

Kode error untuk pencarian URL AMP batch.

Enumerasi
ERROR_CODE_UNSPECIFIED Error tidak ditentukan.
INPUT_URL_NOT_FOUND Mengindikasikan bahwa URL yang diminta tidak ditemukan dalam indeks, mungkin karena URL tidak dapat ditemukan, tidak dapat diakses oleh Googlebot, atau error lainnya.
NO_AMP_URL Mengindikasikan tidak ada URL AMP yang sesuai dengan URL yang diminta.
APPLICATION_ERROR Mengindikasikan semacam error aplikasi pada server. Klien disarankan untuk mencoba lagi.
URL_IS_VALID_AMP TIDAK DIGUNAKAN LAGI: Menunjukkan URL yang diminta adalah URL AMP yang valid. Ini adalah status non-error, tidak boleh diandalkan sebagai tanda berhasil atau gagal. API ini akan dihapus pada versi API mendatang.
URL_IS_INVALID_AMP Menunjukkan bahwa URL AMP telah ditemukan yang sesuai dengan URL permintaan, tetapi bukan HTML AMP yang valid.

Cobalah!