Method: ampUrls.batchGet

แสดงผล URL ของ AMP และ URL แคชของ AMP ที่เทียบเท่า

คำขอ HTTP

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

URL ใช้ไวยากรณ์ข้อมูลเสริม HTTP ของ Google API

เนื้อหาของคำขอ

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
ช่อง
urls[]

string

รายการ URL ที่จะมองหา URL ของ AMP ที่จับคู่กันแล้ว URL จะคํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ สูงสุด 50 URL ต่อการค้นหา (ดูขีดจํากัดการใช้งาน)

lookupStrategy

enum(LookupStrategy)

กําลังขอ lookupStrategy

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การตอบกลับ URL ของ AMP เป็นกลุ่ม

การแสดง JSON
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
ช่อง
ampUrls[]

object(AmpUrl)

การตอบสนองของ URL แต่ละรายการใน BatchAmpUrlsRequest การตอบกลับอาจไม่ใช่ลําดับเดียวกับ URL ในคําขอแบบกลุ่ม หาก BatchAmpUrlsRequest มี URL ที่ซ้ํากัน ระบบจะสร้าง AmpUrl เพียงครั้งเดียวเท่านั้น

urlErrors[]

object(AmpUrlError)

ข้อผิดพลาดของ URL ที่ขอซึ่งไม่มี URL ของ AMP

กลยุทธ์การค้นหา

Enum
FETCH_LIVE_DOC กลยุทธ์ FETCH_LIVE_DOC ประกอบด้วยการดึงข้อมูลเอกสารแบบเรียลไทม์ของ URL ที่ไม่พบในดัชนี ระบบจะรวบรวมข้อมูล URL คําขอที่ไม่พบในดัชนีแบบเรียลไทม์ เพื่อตรวจสอบว่ามี URL ของ AMP ที่เกี่ยวข้องหรือไม่ กลยุทธ์นี้ครอบคลุมพื้นที่เพิ่มมากขึ้นแต่มีเวลาในการตอบสนองที่เพิ่มขึ้นซึ่งได้จากการรวบรวมข้อมูลแบบเรียลไทม์ กลยุทธ์นี้เป็นค่าเริ่มต้น แอปพลิเคชันที่ใช้กลยุทธ์นี้ควรตั้งค่าระยะหมดเวลาของการเรียก API ที่สูงขึ้น
IN_INDEX_DOC กลยุทธ์ IN_INDEX_DOC ข้ามการเรียกเอกสารแบบเรียลไทม์ของ URL ที่ไม่พบในดัชนี ขอแนะนําให้ใช้แอปพลิเคชันที่ต้องใช้กลยุทธ์ IN_INDEX_DOC ในเวลาในการตอบสนองต่ํา

AMP URL

การตอบกลับ URL ของ AMP สําหรับ URL ที่ขอ

การแสดง JSON
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
ช่อง
originalUrl

string

URL เดิมที่ไม่ใช่ AMP

ampUrl

string

URL ของ AMP ที่ชี้ไปยังเว็บเซิร์ฟเวอร์ของผู้เผยแพร่โฆษณา

cdnAmpUrl

string

URL แคช AMP ที่ชี้ไปยังเอกสารที่แคชไว้ในแคช AMP ของ Google

ข้อผิดพลาด URL ของ AMP

ทรัพยากรข้อผิดพลาด URL ของ AMP สําหรับ URL ที่ขอซึ่งอาจไม่พบรหัส #39

การแสดง JSON
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
ช่อง
errorCode

enum(ErrorCode)

รหัสข้อผิดพลาดของการเรียก API

errorMessage

string

ข้อความแสดงข้อผิดพลาดที่สื่อความหมายซึ่งไม่บังคับ

originalUrl

string

URL เดิมที่ไม่ใช่ AMP

รหัสข้อผิดพลาด

รหัสข้อผิดพลาดสําหรับการค้นหา URL ของ AMP แบบกลุ่ม

Enum
ERROR_CODE_UNSPECIFIED ไม่ได้ระบุข้อผิดพลาด
INPUT_URL_NOT_FOUND ระบุว่าไม่พบ URL ที่ขอในดัชนี ซึ่งอาจเป็นเพราะไม่พบ URL หรือไม่สามารถเข้าถึงได้โดย Googlebot หรือข้อผิดพลาดอื่นๆ
NO_AMP_URL บ่งบอกว่าไม่พบ URL ของ AMP ที่ตรงกับ URL ที่ขอ
APPLICATION_ERROR ระบุว่าแอปพลิเคชันเกิดข้อผิดพลาดบางอย่างขึ้นในเซิร์ฟเวอร์ ไคลเอ็นต์แนะนําให้ลองอีกครั้ง
URL_IS_VALID_AMP เลิกใช้งานแล้ว: บ่งบอกว่า URL ที่ขอเป็น URL ของ AMP ที่ถูกต้อง สถานะนี้ไม่ใช่ข้อผิดพลาด ไม่ควรใช้สัญลักษณ์ของความสําเร็จหรือล้มเหลว ซึ่งจะถูกนําออกใน API เวอร์ชันต่อๆ ไป
URL_IS_INVALID_AMP ระบุว่าพบ URL ของ AMP ที่ตรงกับ URL ของคําขอ แต่ไม่ใช่ AMP HTML ที่ถูกต้อง

ลองใช้เลย