Metoda: ampUrls.batchGet

Zwraca adresy URL AMP i odpowiednie adresy URL pamięci podręcznej AMP.

Żądanie HTTP

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

W adresie URL jest używana składnia adnotacji HTTP interfejsów Google API.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Pola
urls[]

string

Lista adresów URL, dla których należy wyszukać sparowane adresy URL AMP. Wielkość liter w adresach URL jest rozróżniana. Maksymalnie 50 adresów URL na wyszukiwanie (patrz Limity wykorzystania).

lookupStrategy

enum(LookupStrategy)

Żądana strategia wyszukiwania lookupStrategy.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Odpowiedź z serią adresów URL AMP.

Zapis JSON
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Pola
ampUrls[]

object(AmpUrl)

Odpowiedź z adresem URL dla każdego adresu URL w żądaniu BatchAmpUrlsRequest. Odpowiedź może mieć inną kolejność niż adresy URL w żądaniu zbiorczym. Jeśli żądanie BatchAmpUrlsRequest zawiera duplikaty adresów URL, pole AmpUrl jest generowane tylko raz.

urlErrors[]

object(AmpUrlError)

Błędy w przypadku żądanych adresów URL, dla których nie istnieją adresy URL AMP.

LookupStrategy

Wartości w polu enum
FETCH_LIVE_DOC Strategia FETCH_LIVE_DOC obejmuje pobranie opublikowanego dokumentu w przypadku adresów URL nieznalezionych w indeksie. Każdy żądany adres URL nieznaleziony w indeksie jest indeksowany w czasie rzeczywistym, by sprawdzić, czy istnieje odpowiedni adres URL AMP. Ta strategia ma większy zasięg, ale indeksowanie w czasie rzeczywistym powoduje dodatkowe opóźnienie. Jest to strategia domyślna. W aplikacjach, które z niej korzystają, należy ustawić dłuższe limity czasu oczekiwania na wywołania interfejsu API.
IN_INDEX_DOC Strategia IN_INDEX_DOC pomija pobieranie opublikowanych dokumentów w przypadku adresów URL nieznalezionych w indeksie. Jest ona zalecana w zastosowaniach, w których opóźnienie powinno być jak najkrótsze.

AmpUrl

Odpowiedź z adresem URL AMP dla adresu URL z żądania.

Zapis JSON
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Pola
originalUrl

string

Oryginalny adres URL (nie-AMP).

ampUrl

string

Adres URL AMP wskazujący serwer WWW wydawcy.

cdnAmpUrl

string

Adres URL pamięci podręcznej AMP wskazujący dokument zapisany w Google AMP Cache.

AmpUrlError

Zasób błędu adresu URL AMP dla nieznalezionego adresu URL z żądania.

Zapis JSON
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Pola
errorCode

enum(ErrorCode)

Kod błędu wywołania interfejsu API.

errorMessage

string

Opcjonalny opisowy komunikat o błędzie.

originalUrl

string

Oryginalny adres URL (nie-AMP).

ErrorCode

Kody błędów dla wyszukiwania serii adresów URL AMP.

Wartości w polu enum
ERROR_CODE_UNSPECIFIED Nieokreślony błąd.
INPUT_URL_NOT_FOUND Wskazuje, że żądany adres URL nie został znaleziony w indeksie. Prawdopodobnie nie można go znaleźć, Googlebot nie ma do niego dostępu lub wystąpił inny błąd.
NO_AMP_URL Wskazuje, że nie znaleziono adresu URL AMP odpowiadającego adresowi URL z żądania.
APPLICATION_ERROR Wskazuje, że na serwerze wystąpił błąd aplikacji. Klient powinien spróbować ponownie.
URL_IS_VALID_AMP WYCOFANY: wskazuje, że adres URL z żądania jest prawidłowym adresem URL AMP. To nie jest stan błędu i nie należy na jego podstawie określać powodzenia lub niepowodzenia żądania. Ten stan zostanie usunięty w przyszłych wersjach interfejsu API.
URL_IS_INVALID_AMP Wskazuje, że znaleziono adres URL AMP, który odpowiada adresowi URL z żądania, ale nie jest to prawidłowy kod AMP HTML.

Wypróbuj