Method assetlinks.check

พิจารณาว่ามีความสัมพันธ์ที่ระบุ (ทิศทาง) ระหว่างชิ้นงานแหล่งที่มาและเป้าหมายที่ระบุหรือไม่

ความสัมพันธ์นี้จะอธิบายเจตนาของการลิงก์ระหว่างเนื้อหาทั้ง 2 รายการตามที่ชิ้นงานแหล่งที่มาอ้างสิทธิ์ ตัวอย่างของความสัมพันธ์ดังกล่าวคือการมอบสิทธิ์หรือสิทธิ์ต่างๆ

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

หมายเหตุเกี่ยวกับความปลอดภัย: หากคุณระบุแหล่งข้อมูลที่ปลอดภัยเป็นเนื้อหา เช่น เว็บไซต์ HTTPS หรือแอป Android API จะตรวจสอบว่าข้อความที่ใช้สร้างการตอบกลับนั้นสร้างขึ้นด้วยวิธีที่ปลอดภัยโดยเจ้าของเนื้อหานั้น ในทางกลับกัน หากเนื้อหาแหล่งที่มาเป็นเว็บไซต์ HTTP ที่ไม่ปลอดภัย (กล่าวคือ URL ขึ้นต้นด้วย http:// แทนที่จะเป็น https://) API จะยืนยันข้อความของตนเองอย่างปลอดภัยไม่ได้ และจะไม่มั่นใจได้ว่าข้อความของเว็บไซต์ดังกล่าวไม่มีการเปลี่ยนแปลงโดยบุคคลที่สาม ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดทางเทคนิคในการออกแบบลิงก์เนื้อหาดิจิทัล (Digital Asset Links)

คำขอ HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

พารามิเตอร์การค้นหา

ชื่อพารามิเตอร์ ประเภท คำอธิบาย
source object(Asset) แหล่งที่มาที่โฮสต์รายการใบแจ้งยอด ใช้เพื่อกำหนดเส้นทางการเรียก Check() ไปยังต้นทางที่เหมาะสม
relation string

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

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

โปรดดูเอกสารประกอบของ 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 ไม่ได้เปิดเผยข้อมูลที่คุณต้องการ โปรดติดต่อเราก่อน

ลองใช้เลย

ใช้โปรแกรมสำรวจ APIs เพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบเรียลไทม์และดูการตอบกลับ