Method: ampUrls.batchGet

Trả về (các) URL AMP và URL bộ nhớ đệm AMP tương đương.

Yêu cầu HTTP

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

URL sử dụng cú pháp chú thích Google API HTTP.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Các trường
urls[]

string

Danh sách URL cần tra cứu để tìm các URL AMP được ghép nối. Các URL có phân biệt chữ hoa chữ thường. Tối đa 50 URL cho mỗi lần tra cứu (xem Giới hạn sử dụng).

lookupStrategy

enum(LookupStrategy)

Chiến lược tra cứu đang được yêu cầu.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Phản hồi hàng loạt URL AMP.

Biểu diễn dưới dạng JSON 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Các trường
ampUrls[]

object(AmpUrl)

Đối với mỗi URL trong BatchAmpUrlsRequest, URL phản hồi là URL. Nội dung phản hồi có thể không theo thứ tự như các URL trong yêu cầu hàng loạt. Nếu BatchAmpUrlsRequest chứa các URL trùng lặp, thì AmpUrl chỉ được tạo một lần.

urlErrors[]

object(AmpUrlError)

Lỗi cho những URL được yêu cầu không có URL AMP.

Chiến lược tìm kiếm

Enum
FETCH_LIVE_DOC Chiến lược SwG_LIVE_DOC sử dụng quy trình tìm nạp tài liệu trực tiếp gồm các URL không có trong chỉ mục. Mọi URL yêu cầu không tìm thấy trong chỉ mục đều được thu thập dữ liệu trong thời gian thực để xác thực xem có URL AMP tương ứng hay không. Chiến lược này có phạm vi bao quát hơn nhưng có độ trễ cao hơn do hoạt động thu thập dữ liệu theo thời gian thực đưa ra. Đây là chiến lược mặc định. Các ứng dụng sử dụng chiến lược này nên đặt thời gian chờ HTTP cao hơn trong các lệnh gọi API.
IN_INDEX_DOC Chiến lược IN_INDEX_DOC bỏ qua việc tìm nạp tài liệu trực tiếp của(các) URL không tìm thấy trong chỉ mục. Đối với các ứng dụng cần độ trễ thấp, chiến lược IN_INDEX_DOC được đề xuất.

AmpUrl

Phản hồi URL AMP cho URL được yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Các trường
originalUrl

string

URL gốc không phải AMP.

ampUrl

string

URL AMP trỏ đến máy chủ web của nhà xuất bản.

cdnAmpUrl

string

URL Bộ nhớ đệm AMP trỏ đến tài liệu được lưu vào bộ nhớ đệm trong Bộ nhớ đệm AMP của Google.

Lỗi AmpUrl

Tài nguyên Lỗi URL AMP cho một URL được yêu cầu không tìm thấy.

Biểu diễn dưới dạng JSON 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Các trường
errorCode

enum(ErrorCode)

Mã lỗi của lệnh gọi API.

errorMessage

string

Một thông báo lỗi mô tả (không bắt buộc).

originalUrl

string

URL gốc không phải AMP.

Mã lỗi

Mã lỗi để tra cứu URL AMP hàng loạt.

Enum
ERROR_CODE_UNSPECIFIED Lỗi không xác định.
INPUT_URL_NOT_FOUND Cho biết không tìm thấy URL được yêu cầu trong chỉ mục, có thể là do Googlebot không tìm thấy, không thể truy cập vào Googlebot hoặc một số lỗi khác.
NO_AMP_URL Cho biết không tìm thấy URL AMP tương ứng với URL được yêu cầu.
APPLICATION_ERROR Cho biết đã xảy ra lỗi ứng dụng nào đó trên máy chủ. Khách hàng nên thử lại.
URL_IS_VALID_AMP ĐÃ NGỪNG HOẠT ĐỘNG: Cho biết URL được yêu cầu là URL AMP hợp lệ. Đây là trạng thái không phải lỗi, không nên coi là dấu hiệu cho biết thành công hay không. Phiên bản này sẽ bị xoá trong các phiên bản sau của API.
URL_IS_INVALID_AMP Cho biết rằng đã có một URL AMP tương ứng với URL yêu cầu nhưng không phải là HTML AMP hợp lệ.

Hãy dùng thử!