Method statements.list

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

API รับประกันได้ว่าคําแถลงทั้งหมดซึ่งมีชิ้นงานแหล่งที่มาที่ปลอดภัย เช่น เว็บไซต์ HTTPS หรือแอป Android ได้ดําเนินการอย่างปลอดภัยโดยเจ้าของเนื้อหาเหล่านั้น ตามที่อธิบายไว้ในข้อกําหนดการออกแบบทางเทคนิคของลิงก์เนื้อหาดิจิทัล โดยเฉพาะอย่างยิ่ง คุณควรคํานึงถึงว่าเว็บไซต์ที่ไม่ปลอดภัย (เช่น ที่ 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> เป็นสตริงที่เป็นตัวอักษรและตัวเลขคละกันแบบอิสระซึ่งอธิบาย Use Case ที่เจาะจงของใบแจ้งยอด

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

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

ลองใช้เลย

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