Method assetlinks.check

ระบุว่ามีความสัมพันธ์ที่ระบุ (โดยตรง) ระหว่างเนื้อหาแหล่งที่มาและเนื้อหาเป้าหมายที่ระบุหรือไม่

ความสัมพันธ์นั้นอธิบายเจตนาของลิงก์ระหว่างเนื้อหา 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(Asset) แหล่งที่มาที่โฮสต์รายการคําสั่ง ใช้เพื่อกําหนดเส้นทางการเรียก Check() ไปยังแหล่งที่มาที่เหมาะสม
relation string

สตริงการค้นหาสําหรับความสัมพันธ์

เราระบุความสัมพันธ์กับสตริงรูปแบบ <kind>/<detail> โดยที่ <kind> ต้องเป็นหนึ่งในชุดหมวดหมู่วัตถุประสงค์ที่กําหนดไว้ล่วงหน้า และ <detail> เป็นสตริงที่เป็นตัวอักษรและตัวเลขคละกันแบบอิสระซึ่งอธิบาย Use Case ที่เจาะจงของใบแจ้งยอด

โปรดดูรายการเอกสารสนับสนุนที่รองรับในปัจจุบันจากเอกสารประกอบเกี่ยวกับ API

คําค้นหาต้องตรงกับลิงก์ชิ้นงาน ทั้งสตริงความสัมพันธ์ของสตริงการค้นหาและคําค้นหาต้องตรงกันทุกประการ

ตัวอย่าง: คําค้นหาที่มีความสัมพันธ์ delegate_permission/common.handle_all_urls ตรงกับลิงก์ของเนื้อหาที่มีความสัมพันธ์ delegate_permission/common.handle_all_urls
target object(Asset) ชิ้นงานเป้าหมายของใบแจ้งยอด

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

เนื้อหาของคำขอต้องว่างเปล่า

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

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

ข้อความตอบกลับสําหรับการเรียก CheckASSETLinks

การแสดง JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
ชื่อช่อง ประเภท คำอธิบาย
linked boolean ตั้งค่าเป็นจริงหากชิ้นงานที่ระบุในคําขอลิงก์ด้วยความสัมพันธ์ที่ระบุไว้ในคําขอ ต้องระบุ
maxAge string

จากเวลาให้บริการ ระยะเวลาการตอบสนองควรถือว่าถูกต้องหากยังมีการอัปเดตเพิ่มเติม ต้องระบุ

ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"
debugString string

ข้อความที่ผู้ใช้อ่านได้ซึ่งมีข้อมูลที่ช่วยให้ผู้ใช้ปลายทางเข้าใจ ทําซ้ํา และแก้ไขข้อบกพร่องของผลลัพธ์ได้

ข้อความจะเป็นภาษาอังกฤษ และขณะนี้เราไม่ได้วางแผนที่จะเสนอการแปล

โปรดทราบว่าไม่มีการรับประกันเกี่ยวกับเนื้อหาหรือรูปแบบของสตริงนี้ อาจมีการเปลี่ยนแปลงในด้านต่างๆ โดยไม่ต้องแจ้งให้ทราบ คุณไม่ควรพยายามแยกวิเคราะห์ข้อมูลนี้แบบเป็นโปรแกรม หากคุณรู้สึกว่าต้องทําเช่นนี้เนื่องจาก API ไม่ได้เปิดเผยข้อมูลที่คุณต้องการ โปรดติดต่อเราก่อน

ลองใช้เลย

ใช้ API Explorer เพื่อเรียกข้อมูลนี้ในข้อมูลแบบสดและดูการตอบกลับ