- คำขอ HTTP
- เนื้อความของคําขอ
- เนื้อหาการตอบกลับ
- กลยุทธ์การค้นหา
- AmpUrl
- AmpUrlError
- รหัสข้อผิดพลาด
- ลองใช้งาน
แสดงผล URL ของ AMP และ URL แคชของ AMP ที่เทียบเท่า
คำขอ HTTP
POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet
URL ใช้ไวยากรณ์ข้อมูลเสริม HTTP ของ Google API
เนื้อหาของคำขอ
เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างดังต่อไปนี้
การแสดง JSON | |
---|---|
{ "urls": [ string ] "lookupStrategy": enum(LookupStrategy), } |
ช่อง | |
---|---|
urls[] |
รายการ URL ที่จะมองหา URL ของ AMP ที่จับคู่กันแล้ว URL จะคํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ สูงสุด 50 URL ต่อการค้นหา (ดูขีดจํากัดการใช้งาน) |
lookupStrategy |
กําลังขอ lookupStrategy |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การตอบกลับ URL ของ AMP เป็นกลุ่ม
การแสดง JSON | |
---|---|
{ "ampUrls": [ { object(AmpUrl) } ], "urlErrors": [ { object(AmpUrlError) } ], } |
ช่อง | |
---|---|
ampUrls[] |
การตอบสนองของ URL แต่ละรายการใน BatchAmpUrlsRequest การตอบกลับอาจไม่ใช่ลําดับเดียวกับ URL ในคําขอแบบกลุ่ม หาก BatchAmpUrlsRequest มี URL ที่ซ้ํากัน ระบบจะสร้าง AmpUrl เพียงครั้งเดียวเท่านั้น |
urlErrors[] |
ข้อผิดพลาดของ 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 |
URL เดิมที่ไม่ใช่ AMP |
ampUrl |
URL ของ AMP ที่ชี้ไปยังเว็บเซิร์ฟเวอร์ของผู้เผยแพร่โฆษณา |
cdnAmpUrl |
URL แคช AMP ที่ชี้ไปยังเอกสารที่แคชไว้ในแคช AMP ของ Google |
ข้อผิดพลาด URL ของ AMP
ทรัพยากรข้อผิดพลาด URL ของ AMP สําหรับ URL ที่ขอซึ่งอาจไม่พบรหัส #39
การแสดง JSON | |
---|---|
{ "errorCode": enum(ErrorCode), "errorMessage": string, "originalUrl": string, } |
ช่อง | |
---|---|
errorCode |
รหัสข้อผิดพลาดของการเรียก API |
errorMessage |
ข้อความแสดงข้อผิดพลาดที่สื่อความหมายซึ่งไม่บังคับ |
originalUrl |
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 ที่ถูกต้อง |