Activities: insert

YouTube เลิกใช้งานฟีเจอร์ประกาศของช่องแล้ว และไม่รองรับวิธีนี้อีกต่อไป

ดูรายละเอียดเพิ่มเติมได้ที่ ศูนย์ช่วยเหลือของ YouTube

โพสต์กระดานข่าวสำหรับช่องที่เฉพาะเจาะจง (ผู้ใช้ที่ส่งคำขอต้องได้รับอนุญาตให้ดำเนินการในนามของช่อง)

หมายเหตุ: แม้ว่าทรัพยากร activity จะมีข้อมูลเกี่ยวกับการดำเนินการต่างๆ เช่น ผู้ใช้ให้คะแนนวิดีโอหรือทำเครื่องหมายวิดีโอเป็นรายการโปรด แต่คุณต้องใช้วิธีการ API อื่นๆ เพื่อสร้างทรัพยากร activity เหล่านั้น เช่น คุณจะใช้วิธี videos.rate() ของ API เพื่อจัดเรตวิดีโอ และใช้วิธี playlistItems.insert() เพื่อทำเครื่องหมายวิดีโอเป็นรายการโปรด

ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีต้นทุนโควต้า 50 หน่วย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/activities

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 1 รายการต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part มีไว้สำหรับวัตถุประสงค์ 2 ประการในการดำเนินการนี้ โดยจะระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับของ API จะรวมไว้ด้วย

รายการต่อไปนี้มีpartชื่อที่คุณรวมไว้ในค่าพารามิเตอร์ได้
  • contentDetails
  • id
  • snippet

เนื้อความของคำขอ

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

  • คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

    • snippet.description

  • คุณตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ได้

    • snippet.description
    • contentDetails.bulletin.resourceId

การตอบกลับ

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

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) bulletinTextRequired คำขอต้องใช้วัตถุ snippet ของพร็อพเพอร์ตี้ description เพื่อระบุข้อความสำหรับโพสต์ประกาศ
badRequest (400) invalidMetadata พร็อพเพอร์ตี้ kind ไม่ตรงกับประเภทรหัสที่ระบุ
forbidden (403) forbidden คำขอไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404) playlistNotFound YouTube ไม่พบวิดีโอที่คุณพยายามเชื่อมโยงกับโพสต์กระดานข่าว ตรวจสอบค่าของพร็อพเพอร์ตี้ contentDetails.bulletinPosted.playlistId
notFound (404) videoNotFound YouTube ไม่พบวิดีโอที่คุณพยายามเชื่อมโยงกับโพสต์กระดานข่าว ตรวจสอบค่าของพร็อพเพอร์ตี้ contentDetails.bulletinPosted.videoId
userRateLimitExceeded (403) rateLimitExceeded ไม่สามารถดำเนินการตามคำขอได้เนื่องจากคุณใช้โควต้าเกินแล้ว