การใช้งาน: การติดตาม

ตัวอย่างต่อไปนี้แสดงวิธีใช้ YouTube Data API (v3) เพื่อดำเนินการที่เกี่ยวข้องกับการติดตาม

ดึงข้อมูลการติดตามของช่อง

เรียกใช้เมธอด subscriptions.list เพื่อเรียกข้อมูลการติดตามของช่องที่ต้องการ ระบุช่องได้ 2 วิธีดังนี้

  • หากต้องการเรียกข้อมูลการติดตามของผู้ใช้ที่ตรวจสอบสิทธิ์ในปัจจุบัน ให้ตั้งค่าพารามิเตอร์ mine เป็น true โปรดทราบว่าคําขอที่ใช้พารามิเตอร์ mine จะต้องได้รับสิทธิ์โดยใช้ OAuth 2.0

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
            part=snippet,contentDetails
            &mine=true
  • หากต้องการเรียกข้อมูลการติดตามของช่องอื่น ให้ตั้งค่าพารามิเตอร์ channelId เป็นรหัสช่อง YouTube ที่ไม่ซ้ำกันของช่องนั้น ตัวอย่างด้านล่างแสดงรายการช่องที่ช่อง TED บน YouTube ติดตาม

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
            part=snippet,contentDetails
            &channelId=UCAuUUnT6oDeKwE6v1NGQxug

    หมายเหตุ: API จะแสดงผลรหัสการตอบกลับ HTTP 403 (Forbidden) หากช่องที่ระบุไม่ได้เปิดเผยการติดตามแบบสาธารณะ และเจ้าของช่องไม่ได้ให้สิทธิ์คำขอ

ดูตัวอย่างโค้ดได้จากเอกสารประกอบของเมธอด subscriptions.list

เพิ่มการสมัครใช้บริการ

เรียกใช้เมธอด subscriptions.insert เพื่อเพิ่มการติดตามช่อง คำขอนี้ต้องได้รับสิทธิ์โดยใช้ OAuth 2.0 เนื้อหาของคําขอคือทรัพยากร subscription ที่ตั้งค่าต่อไปนี้

คำขอ API ด้านล่างจะติดตามช่อง TED บน YouTube

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

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

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

ดูตัวอย่างโค้ดได้จากเอกสารประกอบของเมธอด subscriptions.insert

ลบการสมัครใช้บริการ

ตัวอย่างนี้จะลบการสมัครใช้บริการ คำขอนี้ต้องได้รับสิทธิ์โดยใช้ OAuth 2.0 ตัวอย่างนี้มี 2 ขั้นตอน ดังนี้

  • ขั้นตอนที่ 1: เรียกข้อมูลการติดตามสำหรับช่องของผู้ใช้ที่ตรวจสอบสิทธิ์

    เรียกใช้เมธอด subscriptions.list เพื่อเรียกข้อมูลรายการการสมัครใช้บริการ ตัวอย่างข้างต้นสำหรับการเรียกข้อมูลการติดตามของช่องอธิบายวิธีส่งคำขอนี้

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

  • ขั้นตอนที่ 2: ลบการสมัครใช้บริการ

    เรียกใช้เมธอด subscriptions.delete เพื่อลบการสมัครใช้บริการ ตั้งค่าพารามิเตอร์ id ของคําขอเป็นรหัสการสมัครใช้บริการที่ต้องการนําออก คำขอนี้ต้องได้รับสิทธิ์โดยใช้ OAuth 2.0

    คุณต้องตั้งค่าพร็อพเพอร์ตี้ id เพื่อให้คําขอในเครื่องมือสํารวจ API ทํางานได้

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
            id=SUBSCRIPTION_ID

ดูตัวอย่างโค้ดได้จากเอกสารประกอบของเมธอด subscriptions.delete

เรียกข้อมูลรายชื่อผู้ติดตามช่องของผู้ใช้ที่ได้รับอนุญาต

หากต้องการเรียกข้อมูลรายการช่องที่ติดตามช่องของผู้ใช้ที่ตรวจสอบสิทธิ์ในปัจจุบัน ให้เรียกใช้เมธอด subscriptions.list และตั้งค่าพารามิเตอร์ mySubscribers เป็น true คำขอต้องได้รับสิทธิ์โดยใช้ OAuth 2.0

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true