Method statements.list

ดึงรายการของคำสั่งทั้งหมดจากแหล่งที่มาที่ระบุ ซึ่งตรงกับเป้าหมายและสตริงคำสั่งที่ระบุ

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

คำสั่ง List มีประโยชน์มากที่สุดในกรณีที่ไคลเอ็นต์ API ต้องการทราบวิธีที่เนื้อหา 2 รายการเกี่ยวข้องกัน หรือแจกแจงความสัมพันธ์ทั้งหมดจากเนื้อหาแหล่งที่มาบางรายการ ตัวอย่างเช่น ฟีเจอร์ที่ช่วยให้ผู้ใช้ไปยังรายการที่เกี่ยวข้องได้ เมื่อแอปบนอุปกรณ์เคลื่อนที่ทำงานบนอุปกรณ์ ฟีเจอร์นี้จะช่วยให้สามารถไปยังเว็บไซต์หรือโปรไฟล์ Google+ ที่เกี่ยวข้องได้อย่างง่ายดาย

คำขอ HTTP

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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

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

ใช้เฉพาะการเชื่อมโยงที่ตรงกับความสัมพันธ์ที่ระบุ

ดูคำอธิบายโดยละเอียดของสตริงที่เกี่ยวข้องในข้อความ Statement

ข้อความค้นหาตรงกับคำสั่ง ข้อใดข้อหนึ่งต่อไปนี้ต้องเป็นจริง

  • ทั้งสตริงความสัมพันธ์ของคำสั่งและสตริงความสัมพันธ์ของคำสั่งตรงกันทั้งหมด หรือ
  • สตริงความสัมพันธ์ของการค้นหาว่างเปล่าหรือขาดหายไป

เช่น การค้นหาที่มีความสัมพันธ์ delegate_permission/common.handle_all_urls ตรงกับลิงก์ชิ้นงานที่มีความสัมพันธ์ delegate_permission/common.handle_all_urls

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

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

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

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

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

การแสดง JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
ชื่อช่อง ประเภท คำอธิบาย
statements[] object(Statement) รายการข้อความที่ตรงกันทั้งหมดที่พบ
maxAge string

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

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

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

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

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

คำสั่ง

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

ใบแจ้งยอดจะสร้างขึ้นโดยเนื้อหาแหล่งที่มาเสมอ ไม่ว่าจะโดยตรงหรือด้วยการมอบสิทธิ์ไปยังรายการใบแจ้งยอดที่จัดเก็บไว้ที่อื่น

ดูคำจำกัดความของข้อความและชิ้นงานโดยละเอียดได้ที่หน้า Landing Page สําหรับเอกสาร API

การแสดง JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
ชื่อช่อง ประเภท คำอธิบาย
source object(Asset) ทุกใบแจ้งยอดจะมีเนื้อหาแหล่งที่มา ต้องระบุ
relation string

ความเกี่ยวข้องจะระบุถึงการใช้คำสั่งตามที่เจ้าของเนื้อหาแหล่งที่มาต้องการ (กล่าวคือ บุคคลหรือนิติบุคคลที่ออกคำชี้แจง) ทุกถ้อยคำที่สมบูรณ์มีความเกี่ยวข้อง

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

โปรดดูเอกสารประกอบของ API สำหรับรายการความสัมพันธ์ที่รองรับในปัจจุบัน

ตัวอย่าง: delegate_permission/common.handle_all_urls REQUIRED
target object(Asset) ทุกใบแจ้งยอดจะมีเนื้อหาเป้าหมาย ต้องระบุ

ลองใช้เลย

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