ระบุว่ามีความสัมพันธ์ที่ระบุ (โดยตรง) ระหว่างเนื้อหาแหล่งที่มาและเนื้อหาเป้าหมายที่ระบุหรือไม่
ความสัมพันธ์นั้นอธิบายเจตนาของลิงก์ระหว่างเนื้อหา 2 ส่วนตามที่มีการอ้างสิทธิ์โดยเนื้อหาแหล่งที่มา ตัวอย่างความสัมพันธ์ดังกล่าว ได้แก่ การมอบสิทธิ์หรือสิทธิ์ต่างๆ
คําสั่งนี้มักใช้โดยระบบโครงสร้างพื้นฐานเพื่อตรวจสอบเงื่อนไขก่อนการดําเนินการ ตัวอย่างเช่น ลูกค้าอาจต้องการทราบว่าส่ง URL เว็บไปยังแอปบนอุปกรณ์เคลื่อนที่ที่เฉพาะเจาะจงได้ไหม ลูกค้าจะตรวจหาลิงก์เนื้อหาที่เกี่ยวข้องจากเว็บไซต์ไปยังแอปบนอุปกรณ์เคลื่อนที่ได้ เพื่อพิจารณาว่าควรอนุญาตให้มีการดําเนินการหรือไม่
หมายเหตุเกี่ยวกับความปลอดภัย: หากคุณระบุเนื้อหาที่ปลอดภัยเป็นแหล่งที่มา เช่น เว็บไซต์ HTTPS หรือแอป Android API จะตรวจสอบว่าเจ้าของเนื้อหาได้ใช้ข้อความใดๆ ที่ใช้สร้างการตอบกลับด้วยวิธีที่ปลอดภัย ในทางกลับกัน หากเนื้อหาแหล่งที่มาเป็นเว็บไซต์ HTTP ที่ไม่ปลอดภัย (กล่าวคือ URL ขึ้นต้นด้วย http://
แทนที่จะเป็น https://
) API จะยืนยันใบแจ้งยอดอย่างปลอดภัยไม่ได้ และไม่สามารถยืนยันได้ว่า URL ของบุคคลที่สามไม่มีการแก้ไข ดูข้อมูลเพิ่มเติมได้ในข้อกําหนดการออกแบบทางเทคนิคของลิงก์เนื้อหาดิจิทัล (Digital Asset Links)
คำขอ HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
พารามิเตอร์การค้นหา
ชื่อพารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
source |
object( |
แหล่งที่มาที่โฮสต์รายการคําสั่ง ใช้เพื่อกําหนดเส้นทางการเรียก Check() ไปยังแหล่งที่มาที่เหมาะสม |
relation |
string |
สตริงการค้นหาสําหรับความสัมพันธ์ เราระบุความสัมพันธ์กับสตริงรูปแบบ โปรดดูรายการเอกสารสนับสนุนที่รองรับในปัจจุบันจากเอกสารประกอบเกี่ยวกับ API คําค้นหาต้องตรงกับลิงก์ชิ้นงาน ทั้งสตริงความสัมพันธ์ของสตริงการค้นหาและคําค้นหาต้องตรงกันทุกประการ ตัวอย่าง: คําค้นหาที่มีความสัมพันธ์ |
target |
object( |
ชิ้นงานเป้าหมายของใบแจ้งยอด |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับสําหรับการเรียก CheckASSETLinks
การแสดง JSON |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
ชื่อช่อง | ประเภท | คำอธิบาย |
---|---|---|
linked |
boolean |
ตั้งค่าเป็นจริงหากชิ้นงานที่ระบุในคําขอลิงก์ด้วยความสัมพันธ์ที่ระบุไว้ในคําขอ ต้องระบุ |
maxAge |
string |
จากเวลาให้บริการ ระยะเวลาการตอบสนองควรถือว่าถูกต้องหากยังมีการอัปเดตเพิ่มเติม ต้องระบุ ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
debugString |
string |
ข้อความที่ผู้ใช้อ่านได้ซึ่งมีข้อมูลที่ช่วยให้ผู้ใช้ปลายทางเข้าใจ ทําซ้ํา และแก้ไขข้อบกพร่องของผลลัพธ์ได้ ข้อความจะเป็นภาษาอังกฤษ และขณะนี้เราไม่ได้วางแผนที่จะเสนอการแปล โปรดทราบว่าไม่มีการรับประกันเกี่ยวกับเนื้อหาหรือรูปแบบของสตริงนี้ อาจมีการเปลี่ยนแปลงในด้านต่างๆ โดยไม่ต้องแจ้งให้ทราบ คุณไม่ควรพยายามแยกวิเคราะห์ข้อมูลนี้แบบเป็นโปรแกรม หากคุณรู้สึกว่าต้องทําเช่นนี้เนื่องจาก API ไม่ได้เปิดเผยข้อมูลที่คุณต้องการ โปรดติดต่อเราก่อน |
ลองใช้เลย
ใช้ API Explorer เพื่อเรียกข้อมูลนี้ในข้อมูลแบบสดและดูการตอบกลับ