Method: ampUrls.batchGet

傳回 AMP 網址和對等的 AMP 快取網址。

HTTP 要求

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

這個網址使用 Google API HTTP 註解語法。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
欄位
urls[]

string

要查詢已配對的 AMP 網址的網址清單。網址區分大小寫。每次查詢最多 50 個網址 (請參閱用量限制)。

lookupStrategy

enum(LookupStrategy)

要求的 lookupStrategy。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

批次 AMP 網址回應。

JSON 表示法 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
欄位
ampUrls[]

object(AmpUrl)

針對 BatchAmpUrlsRequest 中的每個網址，網址回應。回應的順序可能與批次要求中的網址順序不同。如果 BatchAmpUrlsRequest 含有重複的網址，則 AmpUrl 只會產生一次。
urlErrors[]

object(AmpUrlError)

要求網址不含 AMP 網址的錯誤訊息。

搜尋策略

列舉
FETCH_LIVE_DOC FETCH_LIVE_DOC 策略涉及在索引中找不到網址的即時文件擷取作業。Google 會即時檢索在索引中找不到的所有要求網址，驗證是否有對應的 AMP 網址。這項策略的涵蓋範圍較長，但即時檢索功能會導入額外的延遲時間。這是預設策略。採用這項策略的應用程式應會設定較高的 API 呼叫 HTTP 逾時時間。
IN_INDEX_DOC IN_INDEX_DOC 策略會略過擷取索引中找不到網址的即時文件。針對需要低延遲延遲時間的應用程式，建議使用 IN_INDEX_DOC 策略。

AMP 網址

要求網址的 AMP 網址回應。

JSON 表示法 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
欄位
originalUrl

string

原始非 AMP 網址。

ampUrl

string

指向發布者網路伺服器的 AMP 網址。

cdnAmpUrl

string

指向 Google AMP 快取中快取文件的 AMP 快取網址。

AmpUrlError

要求的網址找不到 AMP 網址錯誤資源。

JSON 表示法 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
欄位
errorCode

enum(ErrorCode)

API 呼叫的錯誤代碼。
errorMessage

string

選填的描述性錯誤訊息。
originalUrl

string

原始非 AMP 網址。

ErrorCode

批次 AMP 網址查詢的錯誤代碼。

列舉
ERROR_CODE_UNSPECIFIED 未指定錯誤。
INPUT_URL_NOT_FOUND 表示系統無法在索引中找到你要求的網址，原因可能是找不到 Googlebot、無法存取 Googlebot 或其他網址的錯誤。
NO_AMP_URL 表示找不到與要求網址對應的 AMP 網址。
APPLICATION_ERROR 表示伺服器發生某種應用程式錯誤。建議客戶重試。
URL_IS_VALID_AMP 已淘汰：表示要求的網址是有效的 AMP 網址。這是非錯誤狀態，不應該做為成功或失敗跡象。我們將在日後的 API 版本中將其移除。
URL_IS_INVALID_AMP 表示找到與要求網址對應的 AMP 網址，但不是有效的 AMP HTML。

試試看！