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 策略包括对索引中找不到的网址进行实时文档提取。系统会实时抓取索引中找不到的所有请求网址，以验证是否存在对应的 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 Cache 中缓存文档的 AMP Cache 网址。

AmpUrl 错误

找不到所请求的网址的 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 无法访问该网址或其他某些错误。
NO_AMP_URL 表示未找到与请求的网址对应的 AMP 网址。
APPLICATION_ERROR 表示服务器上发生了某种应用错误。建议客户重试。
URL_IS_VALID_AMP 已弃用：表示请求的网址是有效的 AMP 网址。这是一个非错误状态，不应将其视为成功或失败的标志。它将在未来的 API 版本中移除。
URL_IS_INVALID_AMP 表示已找到与请求网址对应的 AMP 网址，但该网址不是有效的 AMP HTML。

试试看！