Method: ampUrls.batchGet

AMP URL'lerini ve eşdeğer AMP Cache URL'lerini döndürür.

HTTP isteği

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

URL, Google API HTTP ek açıklaması söz dizimini kullanır.

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Alanlar
urls[]

string

Eşlenen AMP URL'leri olup olmadığına bakılacak URL'lerin listesi. URL'ler büyük/küçük harfe duyarlıdır. Arama başına en fazla 50 URL (Kullanım Sınırları bölümüne bakın).

lookupStrategy

enum(LookupStrategy)

İstenen arama stratejisi.

Yanıt metni

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Toplu AMP URL yanıtı.

JSON gösterimi
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Alanlar
ampUrls[]

object(AmpUrl)

BatchAmpUrlsRequest'teki her URL için URL yanıtı. Yanıt, toplu istekteki URL'lerle aynı sırada olmayabilir. BatchAmpUrlsRequest yinelenen URL'ler içeriyorsa AmpUrl yalnızca bir kez oluşturulur.

urlErrors[]

object(AmpUrlError)

AMP URL'si olmayan istenen URL'ler için hatalar.

Arama Stratejisi

Sıralamalar
FETCH_LIVE_DOC FETCH_LIVE_DOC stratejisi, dizinde bulunmayan URL'lerin canlı doküman getirmesini içerir. Dizinde bulunmayan tüm istek URL'leri, karşılık gelen bir AMP URL'sinin olup olmadığını doğrulamak için gerçek zamanlı olarak taranır. Bu strateji, daha geniş bir kapsama sahiptir ancak gerçek zamanlı taramanın neden olduğu ek gecikmeyle ilişkilidir. Bu, varsayılan stratejidir. Bu stratejiyi kullanan uygulamalarda daha yüksek HTTP zaman aşımları ayarlanmalıdır.
IN_INDEX_DOC IN_INDEX_DOC stratejisi, dizinde bulunmayan URL'lerin canlı dokümanlarını getirme işlemini atlar. Gecikme süresi düşük olan IN_INDEX_DOC stratejisinin kullanılması önerilir.

AmpUrl

İstenen bir URL için AMP URL yanıtı.

JSON gösterimi
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Alanlar
originalUrl

string

Orijinal AMP olmayan URL.

ampUrl

string

Yayıncının web sunucusunu işaret eden AMP URL'si.

cdnAmpUrl

string

Google AMP Cache'de önbelleğe alınan dokümana işaret eden AMP Cache URL'si.

AmpUrl Hatası

İstenen URL'nin bulunamaması nedeniyle AMP URL Hatası kaynağı.

JSON gösterimi
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Alanlar
errorCode

enum(ErrorCode)

API çağrısının hata kodu.

errorMessage

string

İsteğe bağlı açıklayıcı hata mesajı.

originalUrl

string

Orijinal AMP olmayan URL.

ErrorCode

Toplu AMP URL araması için hata kodları.

Sıralamalar
ERROR_CODE_UNSPECIFIED Belirtilmeyen hata.
INPUT_URL_NOT_FOUND Muhtemelen istenen URL'nin bulunamaması, Googlebot tarafından erişilemez olması veya başka bir hata nedeniyle istenen URL'nin dizinde bulunamadığını belirtir.
NO_AMP_URL İstenen URL'ye karşılık gelen bir AMP URL'sinin bulunamadığını gösterir.
APPLICATION_ERROR Sunucuda bir tür uygulama hatası oluştuğunu belirtir. Müşterinin yeniden denemesi önerilir.
URL_IS_VALID_AMP KULLANIMDAN KALDIRILDI: İstenen URL'nin geçerli bir AMP URL'si olduğunu belirtir. Bu bir hata değildir ve başarı veya başarısızlık işareti olarak kabul edilmemelidir. API'nin gelecekteki sürümlerinde kaldırılacaktır.
URL_IS_INVALID_AMP İstek URL'sine karşılık gelen bir AMP URL'sinin bulunduğunu, ancak geçerli AMP HTML olmadığını belirtir.

Deneyin.