API สำหรับ Content ID ของ YouTube - ประวัติการแก้ไข

หมายเหตุ: YouTube Data API มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube และนักพัฒนาซอฟต์แวร์หรือผู้ใช้ YouTube บางรายจะเข้าถึง API นี้ไม่ได้ โดยคุณต้องมีบัญชีระบบจัดการเนื้อหาของ YouTube จึงจะเข้าถึงได้ หากมีบัญชี YouTube Content Manager แต่ไม่เห็น YouTube Data API เป็นหนึ่งในบริการที่แสดงในคอนโซล Google Cloud โปรดติดต่อผู้จัดการพาร์ทเนอร์หรือทีมสนับสนุนพาร์ทเนอร์ที่ได้รับมอบหมาย

หน้านี้แสดงการเปลี่ยนแปลงใน API สำหรับ Content ID ของ YouTube และการอัปเดตเอกสารประกอบ

27 สิงหาคม 2026

YouTube จะปรับวิธีการนับยอดดูแบบสาธารณะสำหรับวิดีโอทุกรูปแบบ ได้แก่ วิดีโอแบบยาว ไลฟ์สด และ Shorts YouTube จะนับยอดดูแบบสาธารณะทันทีที่วิดีโอเริ่มเล่น

การมีสิทธิ์สร้างรายได้และเมตริกประสิทธิภาพหลักส่วนใหญ่จะไม่ได้รับผลกระทบ เนื่องจากยังคงอิงตามเมตริกการมีส่วนร่วม รายได้ของครีเอเตอร์จะยังคงอิงตาม "ยอดดู Shorts อย่างมีส่วนร่วม" และ "เวลาในการรับชมอย่างมีส่วนร่วม" ซึ่งคุณสามารถดูได้ใน YouTube Analytics > โหมดขั้นสูง

การได้รับสิทธิ์เข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube จะไม่มีการเปลี่ยนแปลง นอกจากนี้ ข้อกำหนดในการเข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube จะเรียกว่า "ยอดดู Shorts ที่เข้าเกณฑ์" และ "เวลาในการรับชมที่เข้าเกณฑ์" (เดิมคือ "ยอดดู Shorts สาธารณะที่เข้าเกณฑ์" และ "เวลาในการรับชมวิดีโอสาธารณะที่เข้าเกณฑ์")

ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจประสิทธิภาพเนื้อหาของคุณบน YouTube

เมตริก	สถานะ	ทริกเกอร์	ใช้สำหรับ
ดู	อัปเดตแล้ว	วิดีโอจะเล่นจากเฟรมแรก (รวมถึงการเล่นอัตโนมัติ วางเมาส์เหนือ และคลิก/แตะเพื่อเล่น)	ยอดดูแบบสาธารณะมาตรฐาน
การดูอย่างมีส่วนร่วม	ไม่มีการเปลี่ยนแปลง	การเล่นจะดำเนินต่อไปหลังจากเฟรมแรก หรือผู้ใช้คลิก/แตะเพื่อเล่น	การสร้างรายได้ผ่านโปรแกรมพาร์ทเนอร์ YouTube, ข้อมูลวิเคราะห์หลักส่วนใหญ่ (อัตราการคลิกผ่าน, ระยะเวลาการดูโดยเฉลี่ย) และการรายงานการมีส่วนร่วม
การแสดงผลภาพปก	ไม่มีการเปลี่ยนแปลง	ภาพปกจะแสดงโดยไม่ต้องมีการโต้ตอบหรือเล่นอัตโนมัติ	วัดการแสดงผลและการจัดแพ็กเกจระดับฟีด

4 สิงหาคม 2026

เราได้อัปเดตเอกสารประกอบเกี่ยวกับ YouTube Content ID API เพื่อชี้แจงลำดับการดำเนินการเมื่ออัปเดตเนื้อหาที่เจ้าของเนื้อหารายอื่นเป็นเจ้าของอยู่แล้ว ดังนี้

• หากเนื้อหามีเจ้าของเป็นเจ้าของเนื้อหารายอื่นอยู่แล้ว คุณต้องเพิ่มการเป็นเจ้าของเนื้อหาโดยใช้ ownership.update หรือ ownership.patch ก่อนจึงจะตั้งค่าหรืออัปเดตข้อมูลเมตาหรือนโยบายการจับคู่ได้
• หากพยายามอัปเดตข้อมูลเมตา (assets.update หรือ assets.patch) หรือนโยบายการจับคู่ (assetMatchPolicy.update หรือ assetMatchPolicy.patch) ก่อนอ้างสิทธิ์ความเป็นเจ้าของ คำขอจะไม่สำเร็จและแสดงข้อผิดพลาด PERMISSION_DENIED
• เราได้อัปเดตคำแนะนำอัปเดตป้ายกำกับของเนื้อหาพร้อมวิธีการทีละขั้นตอนในการเพิ่มป้ายกำกับให้กับเนื้อหาที่เป็นของเจ้าของเนื้อหารายอื่น

26 มีนาคม 2025

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป YouTube จะเปลี่ยนวิธีนับยอดดู Shorts ในอดีต YouTube จะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที ตอนนี้ระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีข้อกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม

ภายในวันที่ 30 มิถุนายน 2025 เราจะอัปเดต Content ID API ในลักษณะต่อไปนี้ตามการเปลี่ยนแปลงนี้

• claimSearch.list.sort จะได้รับการอัปเดตลำดับการจัดเรียงดังนี้
  • DAILY_ENGAGED_VIEWS จะเพิ่มให้กับยอดดูรายวันโดยอิงตามวิธีการนับยอดดูก่อนหน้า
  • LIFETIME_ENGAGED_VIEWS จะเพิ่มลงในยอดดูทั้งหมดตามวิธีการนับยอดดูก่อนหน้านี้
• assetSearch.list.sort จะได้รับการอัปเดตลำดับการจัดเรียงดังนี้
  • DAILY_ENGAGED_VIEWS จะเพิ่มให้กับยอดดูรายวันโดยอิงตามวิธีการนับยอดดูก่อนหน้า

ภายในวันที่ 30 กันยายน 2025 เราจะอัปเดต Content ID API ในลักษณะต่อไปนี้ตามการเปลี่ยนแปลงนี้

• ระบบจะเลิกใช้งานassetSearch.list.sortลำดับการจัดเรียงVIEWS
• ระบบจะเลิกใช้งานclaimSearch.list.sortลำดับการจัดเรียงVIEW_COUNT
• claimSearch.claimSnippet.videoViews จะได้รับการอัปเดตให้แสดงวิธีการนับยอดดูที่อัปเดตแล้วสำหรับยอดดูของ Shorts
• ระบบจะเพิ่ม claimSearch.claimSnippet.engagedViews สำหรับยอดดูตามวิธีการนับยอดดูแบบเดิม

14 มกราคม 2025

เราได้อัปเดตฟิลด์ videoAdvertisingOption ของทรัพยากร autoGeneratedBreaks[] เนื่องจากตอนนี้เราอนุญาตให้ระบุ ad_breaks และ autoGeneratedBreaks พร้อมกันได้แล้ว หากตั้งค่า autoGeneratedBreaks เป็น true ในวิดีโอที่มีการกำหนด adBreaks ระบบของเราจะระบุตำแหน่งที่จะแสดงโฆษณานอกเหนือจากช่องโฆษณาที่คุณกำหนดเอง ดูรายละเอียดเพิ่มเติมได้ในบทความสนับสนุน

10 พฤศจิกายน 2023

ฟิลด์ adFormats[] ของทรัพยากร videoAdvertisingOption ได้รับการอัปเดตเพื่อให้ third_party เป็นค่าที่ใช้ได้ค่าเดียวสำหรับฟิลด์นั้น ระบบจะไม่รองรับรูปแบบโฆษณาต่อไปนี้อีกต่อไป instream_trueview, instream_standard, display, preroll, postroll ดูรายละเอียดเพิ่มเติมได้ในบทความสนับสนุน

1 มิถุนายน 2023

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • เราได้ทำเครื่องหมายฟิลด์ breakPosition[] ของvideoAdvertisingOptionทรัพยากรว่าเลิกใช้งานแล้วและจะนำออกในปี 2024
    เมธอด videoAdvertisingOptions.update และ videoAdvertisingOptions.patch ไม่สนใจฟิลด์นี้อยู่แล้ว
  • ระบบได้นำฟิลด์ adBreaks[].slot[] ที่เลิกใช้งานแล้วของทรัพยากร videoAdvertisingOption ออกแล้ว
  • ระบบได้นำฟิลด์ category และ showCustomId ที่เลิกใช้งานแล้วของทรัพยากร asset ออกแล้ว
  • ฟิลด์ timeStatusLastModified ของclaimทรัพยากรใหม่จะรายงานเวลาที่มีการแก้ไขการอ้างสิทธิ์ครั้งล่าสุด
  • พารามิเตอร์ isVideoShortsEligible ของเมธอด claimSearch.list ใหม่สามารถใช้เพื่อกรองวิดีโอที่อ้างสิทธิ์ตามการมีสิทธิ์ของ YouTube Shorts

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • ตอนนี้ API รองรับการแสดงทรัพยากรของ YouTube Music แล้ว
    • musicRelease resources can be listed with the musicReleases.list method.
    • musicTrack resources can be listed with the musicTracks.list method.
    • musicChangeRequest resources can be listed with the musicChangeRequests.list method.

20 ธันวาคม 2022

เราได้อัปเดตคำจำกัดความของพารามิเตอร์การค้นหาของassetSearch.listเมธอด ownershipRestriction เพื่อชี้แจงว่าหากค่าของพารามิเตอร์นั้นเป็น none ค่าพารามิเตอร์ metadataSearchFields ต้องใช้ตัวกรองรหัสอย่างน้อย 1 รายการด้วย การเปลี่ยนแปลงเอกสารประกอบนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API

9 พฤศจิกายน 2022

เอกสารประกอบสำหรับเมธอด asset.get และ asset.list ได้รับการ อัปเดตเพื่อชี้แจงวิธีรองรับค่าหลายค่าสำหรับรายการต่อไปนี้

• fetchMatchPolicy (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

28 กันยายน 2022

เราได้เพิ่มข้อมูลความสามารถในการขอใบอนุญาตลงใน asset resource แล้ว

18 กรกฎาคม 2022

เราได้อัปเดตเอกสารประกอบสำหรับclaimSearch.listเมธอด inactiveReasons เพื่อให้สอดคล้องกับการปรับปรุงเพื่อความสอดคล้องกับ YouTube Studio ดังนี้

• ก่อนหน้านี้ Studio ได้นำการสนับสนุนสำหรับ Audio Swap และ Song Erase ออกแล้ว ค่า API ที่เกี่ยวข้อง audio_removed และ song_erased ถูก ละเว้นโดยไม่มีการแจ้งเตือนและไม่มีการบันทึกไว้แล้ว
• channel_whitelisted ถูกแทนที่ด้วย channel_allowlisted แล้ว ระบบไม่ได้บันทึกค่าก่อนหน้าแล้ว แต่ยังคงรองรับอยู่
• ตอนนี้ระบบรองรับค่า closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced และ video_modified แล้ว

14 มิถุนายน 2022

เอกสารประกอบของassetSearchทรัพยากร ได้รับการอัปเดตเพื่อให้สอดคล้องกับพร็อพเพอร์ตี้ใหม่ 2 รายการ ได้แก่ isrcs[] และ iswcs[] ค่าพร็อพเพอร์ตี้ isrcs[] และ iswcs[] ใหม่แต่ละรายการมีอาร์เรย์ของค่าสตริง โดยแต่ละค่าจะระบุ ISRC หรือ ISWC ตามความเหมาะสม ซึ่งแมปกับชิ้นงาน ที่ระบุโดยผลการค้นหา

เราขอแนะนําให้ใช้พร็อพเพอร์ตี้ใหม่แทนพร็อพเพอร์ตี้ isrc และ iswc ที่รวมอยู่ในแหล่งข้อมูล assetSearch อยู่แล้ว เนื่องจากพร็อพเพอร์ตี้ใหม่ให้ข้อมูลที่แม่นยำกว่า ในขณะที่พร็อพเพอร์ตี้ใหม่ๆ อาจแสดงอาร์เรย์ของค่าสตริง พร็อพเพอร์ตี้ isrc และ iswc แต่ละรายการจะระบุรหัส ISRC หรือ ISWC เพียงรหัสเดียว ที่เชื่อมโยงกับผลการค้นหา

12 พฤษภาคม 2022

เราได้อัปเดตลิงก์ไปยังไลบรารีของไคลเอ็นต์ให้ชี้ไปยังไลบรารีของไคลเอ็นต์ Google API มาตรฐาน อัปเดตการเชื่อมโยงที่สร้างไว้ล่วงหน้าสำหรับ PHP แล้ว

3 พฤษภาคม 2022

ตอนนี้พารามิเตอร์ status ของเมธอด claimSearch.list รองรับตัวกรองเพิ่มเติมตามรายละเอียดการอ้างสิทธิ์ที่อาจเกิดขึ้น

2 พฤษภาคม 2022

เราได้อัปเดตเอกสารประกอบสำหรับ Response ของเมธอด assetSearch.list เพื่อให้มีความสอดคล้องกับAIP-158 มากยิ่งขึ้น ดังนี้

• คำอธิบายของ pageInfo.totalResults ระบุอย่างชัดเจนว่าค่าดังกล่าวเป็นค่าประมาณ ไม่ใช่ค่าจริง
• ระบบได้นำฟิลด์ pageInfo.resultsPerPage และ pageInfo.startIndex ออกแล้ว

25 เมษายน 2022

เราได้อัปเดตเอกสารประกอบสำหรับทรัพยากร assetLabels.list เพื่อชี้แจงความหมายของพารามิเตอร์คำขอ labelPrefix และ q รวมถึงบันทึกว่าคำขอ / การตอบกลับรองรับการแบ่งหน้า

8 ธันวาคม 2021

เราได้อัปเดตเอกสารประกอบสำหรับclaimSearch.list เพื่อให้แสดงถึง Use Case ทั้ง 2 กรณีที่เมธอดนี้ครอบคลุมอย่างถูกต้อง

• ค้นหาตามรหัส (เนื้อหา ข้อมูลอ้างอิง หรือวิดีโอ) หรือสตริงการค้นหา
• ค้นหาตามวันที่สร้างการอ้างสิทธิ์ วันที่แก้ไข หรือสถานะ

แต่ละกรณีการใช้งานรองรับชุดพารามิเตอร์การค้นหาที่แตกต่างกัน เราได้อัปเดตเอกสารประกอบของเมธอด claimSearch.list เพื่ออธิบายว่าระบบรองรับพารามิเตอร์ใดบ้างสำหรับแต่ละกรณีการใช้งาน

17 พฤศจิกายน 2021

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• ตอนนี้เมธอด claims.update รองรับความสามารถในการอัปเดตสถานะของคำกล่าวอ้างที่ไม่มีการใช้งานหรือคำกล่าวอ้างที่อาจเกิดขึ้นเป็น active แล้ว คำจำกัดความของพร็อพเพอร์ตี้ status ของทรัพยากร claim จะให้รายละเอียดเพิ่มเติม
• เราได้อัปเดตเอกสารประกอบสำหรับแหล่งข้อมูล claim และ claimSearch เพื่อให้สอดคล้องกับการเพิ่มออบเจ็กต์ studioInfo ใหม่ ซึ่งมีลิงก์ไปยังหน้า YouTube Studio ที่เกี่ยวข้องกับการอ้างสิทธิ์
• รายการค่าที่รองรับสำหรับพารามิเตอร์ origin ของเมธอด claimSearch.list มีการเปลี่ยนแปลง ตอนนี้พารามิเตอร์รองรับค่าเพิ่มเติมอีก 4 ค่า ได้แก่ batchTool, inProductShorts, melodyMatch และ youTubeAdmin นอกจากนี้ ระบบจะไม่รองรับค่า dropboxUpload และ webUpload อีกต่อไป

26 กุมภาพันธ์ 2021

เอกสารประกอบสำหรับพารามิเตอร์ videoId ของเมธอด claimSearch.list ได้รับการอัปเดตเพื่อระบุว่าตอนนี้ค่าพารามิเตอร์ยอมรับรหัสวิดีโอที่คั่นด้วยคอมมาได้สูงสุด 10 รายการ API จะแสดงข้อผิดพลาด badRequest ซึ่งเป็นรหัสการตอบกลับ HTTP 400 หากค่ามีรหัสวิดีโอมากกว่า 10 รายการ

6 ธันวาคม 2018

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

เราได้อัปเดตเอกสารประกอบ API เพื่อนำการอ้างอิงถึงทรัพยากร contentOwnerAdvertisingOptions และเมธอดของทรัพยากรดังกล่าวออกแล้ว เราใช้เมธอดเหล่านี้น้อยมาก และได้ติดต่อผู้ใช้ API ที่ใช้เมธอดเหล่านี้แยกต่างหากก่อนที่จะประกาศนี้

21 มีนาคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

24 กรกฎาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• package แหล่งข้อมูลใหม่แสดงถึงกลุ่มไฟล์ที่ส่งผ่านเว็บ, SFTP หรือกลไกการนำส่งอื่นๆ API รองรับ 2 วิธีสำหรับทรัพยากรนี้

  • package.insert วิธีนี้จะตรวจสอบและอัปโหลดแพ็กเกจที่มีข้อมูลเมตาเท่านั้นซึ่งมีไฟล์ข้อมูลเมตา 1 ไฟล์
  • เมธอด package.get จะเรียกข้อมูลเกี่ยวกับแพ็กเกจที่อัปโหลดก่อนหน้านี้

• สำหรับเมธอด validator.validate เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ uploaderName เพื่อระบุว่าค่าดังกล่าวไม่ได้ระบุพาร์ทเนอร์เนื้อหาที่อัปโหลดข้อมูล แต่เป็นค่า เช่น web-google หรือ yt-google ที่ระบุบัญชีผู้อัปโหลดที่เฉพาะเจาะจงซึ่งเจ้าของเนื้อหาใช้

• พร็อพเพอร์ตี้ status ของทรัพยากร reference จะไม่ใช้ค่า duplicate_on_hold เพื่อระบุว่าการอ้างอิงซ้ำกับการอ้างอิงอื่นอีกต่อไป แต่หากการอ้างอิงซ้ำกัน ระบบจะตั้งค่าพร็อพเพอร์ตี้ status เป็น inactive และค่าพร็อพเพอร์ตี้ statusReason เป็น REASON_DUPLICATE_FOR_OWNERS

  อย่างไรก็ตาม เช่นเดียวกับก่อนหน้านี้ ระบบจะป้อนข้อมูลพร็อพเพอร์ตี้ duplicateLeader ของทรัพยากรก็ต่อเมื่อข้อมูลอ้างอิงเป็นข้อมูลที่ซ้ำกันเท่านั้น หากตั้งค่าไว้ ค่าของพร็อพเพอร์ตี้นั้นจะระบุข้อมูลอ้างอิงที่ซ้ำกัน

17 เมษายน 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

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

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

  assetShare ระบุความสัมพันธ์ระหว่างมุมมองการเรียบเรียงและการแชร์การเรียบเรียง assetShares.list วิธีใหม่ช่วยให้คุณทำสิ่งต่อไปนี้ได้

  • ระบุรหัสของมุมมองการเรียบเรียงเพลงและดึงส่วนแบ่งการเรียบเรียงเพลงที่เกี่ยวข้องซึ่งเป็นของพาร์ทเนอร์ที่ให้สิทธิ์คำขอ หากมีส่วนแบ่งดังกล่าว
  • ระบุรหัสของการแชร์การเรียบเรียงเพลงที่เป็นของพาร์ทเนอร์เนื้อหาและดึงรายการมุมมองการเรียบเรียงเพลงทั้งหมดที่ลิงก์กับการแชร์นั้น

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

• พร็อพเพอร์ตี้ใหม่ของcontentOwnerAdvertisingOptionsแหล่งข้อมูล claimedVideoOptions.autoGeneratedBreaks จะระบุว่า YouTube ควรสร้างช่วงพักโฆษณาในวิดีโอที่อ้างสิทธิ์ซึ่งมีความยาวมากกว่า 10 นาทีโดยอัตโนมัติหรือไม่ แม้ว่าพร็อพเพอร์ตี้จะส่งผลต่อวิดีโอทั้งหมดของเจ้าของเนื้อหาที่มีความยาวมากกว่า 10 นาที แต่หากวิดีโอมีการอ้างสิทธิ์หลายรายการ พาร์ทเนอร์รายแรกที่อ้างสิทธิ์ในวิดีโอจะเป็นผู้กำหนดลักษณะการทำงานเริ่มต้นสำหรับพร็อพเพอร์ตี้นี้ที่เกี่ยวข้องกับวิดีโอดังกล่าว

11 สิงหาคม 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดที่อัปเดต") ซึ่งอธิบายไว้โดยละเอียดในบล็อกวิศวกรรมและนักพัฒนาซอฟต์แวร์ของ YouTube มีการอัปเดตข้อกำหนดในการให้บริการปัจจุบันมากมาย นอกเหนือจากข้อกำหนดที่ปรับปรุงแล้ว ซึ่งจะมีผลตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 การปรับปรุงนี้ยังรวมถึงเอกสารประกอบหลายฉบับที่จะช่วยอธิบายนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม

  ชุดเอกสารใหม่ทั้งหมดอธิบายไว้ในประวัติการแก้ไขของข้อกำหนดที่อัปเดต นอกจากนี้ การเปลี่ยนแปลงในอนาคตของข้อกำหนดที่อัปเดตหรือเอกสารประกอบเหล่านั้นจะอธิบายไว้ในประวัติการแก้ไขด้วย คุณติดตามฟีด RSS ที่แสดงการเปลี่ยนแปลงในประวัติการแก้ไขนั้นได้จากลิงก์ในเอกสาร

31 พฤษภาคม 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • validator.validate วิธีใหม่นี้ช่วยให้คุณตรวจสอบได้ว่าไฟล์ข้อมูลเมตามีข้อผิดพลาดในการตรวจสอบความถูกต้องซึ่งจะขัดขวางไม่ให้ YouTube ประมวลผลไฟล์ได้สำเร็จหรือไม่ หากไฟล์มีข้อผิดพลาด พร็อพเพอร์ตี้ errors ของการตอบกลับ API จะมีรายการข้อผิดพลาดในการตรวจสอบความถูกต้อง ซึ่งระบุความรุนแรง สาเหตุ และตำแหน่งของข้อผิดพลาดแต่ละรายการ

• ข้อผิดพลาดใหม่และที่อัปเดต

  • ตอนนี้เมธอด assets.patch และ assets.update รองรับข้อผิดพลาดต่อไปนี้แล้ว โปรดทราบว่าเมธอดรองรับข้อผิดพลาดหลายรายการที่มีประเภทข้อผิดพลาดเดียวกันได้ โปรดดูเอกสารข้อผิดพลาดสำหรับแต่ละเมธอดหรือไปที่หน้าข้อผิดพลาดเพื่อดูรายการข้อผิดพลาดที่เป็นไปได้ทั้งหมด

    ข้อผิดพลาด
    invalidValue (400)	parameters.assetId คำขอล้มเหลวเนื่องจากเนื้อหาที่กำลังอัปเดตถูกผสานกับเนื้อหาอื่น ส่งคำขออีกครั้งโดยใช้รหัสของชิ้นงานนั้น ซึ่งจะแสดงในข้อความแสดงข้อผิดพลาดเป็นค่าของพารามิเตอร์ assetId

28 มีนาคม 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • พร็อพเพอร์ตี้ matchInfo.matchSegments[] ใหม่ของทรัพยากร claim มีรายการที่แต่ละรายการอธิบายส่วนของวิดีโอที่อ้างสิทธิ์ซึ่งตรงกับส่วนหนึ่งของวิดีโออ้างอิง การอ้างสิทธิ์หนึ่งๆ มีกลุ่มที่ตรงกันได้หลายกลุ่ม ตัวอย่างเช่น หากเนื้อหาเสียงและวิดีโอของวิดีโอที่อัปโหลดตรงกับเนื้อหาเสียงและวิดีโอของวิดีโออ้างอิง ก็จะมี 2 ส่วนที่ตรงกัน โดยส่วนหนึ่งจะอธิบายการจับคู่เสียง และอีกส่วนจะอธิบายการจับคู่วิดีโอ

    สำหรับแต่ละกลุ่มที่ตรงกัน API จะแสดงระยะเวลาและประเภท (เสียงหรือวิดีโอ) ของเนื้อหาที่ตรงกัน นอกจากนี้ API ยังระบุออฟเซ็ตเวลาที่ส่วนที่ตรงกันแต่ละส่วนเริ่มต้นและสิ้นสุดทั้งในวิดีโอที่อ้างสิทธิ์และวิดีโออ้างอิงด้วย

  • ตอนนี้คุณอัปเดตค่าพร็อพเพอร์ตี้ของcontentOwnerAdvertisingOptionsทรัพยากรclaimedVideoOptions.newVideoDefaults[]ได้แล้วเมื่อเรียกใช้เมธอด contentOwnerAdvertisingOptions.patch หรือ contentOwnerAdvertisingOptions.update

  • เลิกใช้งานพร็อพเพอร์ตี้ allowedOptions.autoGeneratedBreaks แบบอ่านอย่างเดียวของแหล่งข้อมูล contentOwnerAdvertisingOptions แล้ว

• ข้อผิดพลาดใหม่และที่อัปเดต

  • ตอนนี้เมธอด claims.update ของ API รองรับข้อผิดพลาดต่อไปนี้แล้ว โปรดทราบว่าเมธอดรองรับข้อผิดพลาดหลายรายการที่มีประเภทข้อผิดพลาดเดียวกันได้ โปรดดูเอกสารข้อผิดพลาดสำหรับแต่ละเมธอดหรือไปที่หน้าข้อผิดพลาดเพื่อดูรายการข้อผิดพลาดที่เป็นไปได้ทั้งหมด

    ข้อผิดพลาด
    badRequest (400)	alreadyClaimed การอ้างสิทธิ์เป็นการอ้างสิทธิ์ซ้ำกับการอ้างสิทธิ์อื่นที่มีอยู่แล้วและอัปเดตไม่ได้

  • บางครั้งเมธอด assets.list จะหมดเวลาและแสดงรหัสการตอบกลับ HTTP 500 (Internal Server Error) โดยเฉพาะอย่างยิ่งเมื่อคำขอเรียกข้อมูลสำหรับชิ้นงานจำนวนมากและค่าของพารามิเตอร์ fetchMatchPolicy เป็น effective หากคำขอ assets.list ระบุรหัสเนื้อหาหลายรายการและแสดงข้อผิดพลาด 500 ให้ลองส่งคำขออีกครั้งสำหรับเนื้อหาเดียวหรือเนื้อหาจำนวนน้อยลง

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

3 กุมภาพันธ์ 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • ตอนนี้ API รองรับโฆษณาข้อมูลสินค้าที่แสดงแล้ว โฆษณาข้อมูลสินค้าที่แสดงจะไฮไลต์ผลิตภัณฑ์ที่เกี่ยวข้องหรือแสดงอยู่ในเนื้อหาของวิดีโอ โฆษณาเหล่านี้คือการ์ดผู้สนับสนุนซึ่งแสดงระหว่างเล่นวิดีโอ โดยระบบโฆษณาจะเพิ่มการ์ดนี้โดยอัตโนมัติ ผู้ชมจะเห็นทีเซอร์ของการ์ดเป็นเวลา 2-3 วินาที จากนั้นจึงจะคลิกไอคอนที่มุมบนขวาของวิดีโอเพื่อเรียกดูการ์ดได้

    การเปลี่ยนแปลงนี้ทำให้ตอนนี้คุณสามารถใส่ product_listing ในค่าของพร็อพเพอร์ตี้ต่อไปนี้ได้

    เมธอดของทรัพยากร/API	พร็อพเพอร์ตี้
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • assetSearch.list วิธีการใหม่ของ createdBefore และ createdAfter จะสั่งให้ API แสดงเฉพาะชิ้นงานที่สร้างก่อนและ/หรือหลังวันที่ที่กำหนด

  • ในการตอบกลับ API สำหรับคำขอ assetSearch.list ตอนนี้พร็อพเพอร์ตี้ type รองรับค่า art_track_video แล้ว ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับวิดีโอแทร็กภาพ

  • เมธอด claimSearch.list รองรับพารามิเตอร์ใหม่ต่อไปนี้

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

  • ออบเจ็กต์ references#origination ใหม่ของreferenceทรัพยากรมีข้อมูลที่อธิบายแหล่งที่มาของการอ้างอิง

  • ตอนนี้references.insertวิธีการนี้รองรับความสามารถในการอัปโหลดข้อมูลอ้างอิงที่สร้างขึ้นโดยใช้ซอฟต์แวร์ gfp_gen ของ YouTube แล้ว หากคุณระบูลายนิ้วมือที่สร้างไว้ล่วงหน้า ให้ตั้งค่าพร็อพเพอร์ตี้ fpDirect เป็น true ในทรัพยากร reference ที่อัปโหลด

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

• ข้อผิดพลาดใหม่และที่อัปเดต

  ตอนนี้เอกสารแสดงข้อผิดพลาดที่เมธอดของทรัพยากร whitelist ส่งคืนแล้ว

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

  ข้อผิดพลาด
  badRequest (400)	inappropriateCampaignTarget เมธอด campaigns.insert และ campaigns.update จะแสดงข้อผิดพลาดนี้หากแคมเปญพยายามแสดงวิดีโอที่อาจไม่เหมาะสมสำหรับผู้ใช้บางราย โปรดเลือกเนื้อหาอื่นเพื่อแนะนำเพื่อแก้ไขข้อผิดพลาด
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets เมธอด claims.insert จะแสดงข้อผิดพลาดนี้หากคุณพยายามสร้างการอ้างสิทธิ์ในการอัปโหลดโดยพาร์ทเนอร์ด้วยเนื้อหาการเรียบเรียงเพลงหรือเนื้อหาการบันทึกเสียง
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim เมธอด claims.insert จะแสดงข้อผิดพลาดนี้หากมีการอ้างสิทธิ์สำหรับเพลงที่บันทึกไว้ในวิดีโอที่ระบุอยู่แล้ว คุณเพิ่มการอ้างสิทธิ์การเรียบเรียงโดยตรงผ่าน API ไม่ได้
  badRequest (400)	asset_id เมธอด references.insert จะแสดงข้อผิดพลาดนี้หากคำขอพยายามสร้างการอ้างอิงผ่านไฟล์ แต่คำขอไม่ได้ระบุ assetId
  badRequest (400)	canNotBeActivated เมธอด references.update จะแสดงข้อผิดพลาดนี้หากเปิดใช้งานข้อมูลอ้างอิงไม่ได้ ซึ่งอาจเป็นเพราะสถานะของข้อมูลอ้างอิงหรือเงื่อนไขการเป็นเจ้าของ
  badRequest (400)	videoNotClaimed เมธอด videoAdvertisingOptions.get จะแสดงข้อผิดพลาดนี้หากคุณไม่ได้อ้างสิทธิ์วิดีโอที่พยายามดึงตัวเลือกการโฆษณา ซึ่งทำให้คุณไม่สามารถเข้าถึงข้อมูลที่ขอได้

18 ธันวาคม 2015

กฎหมายของสหภาพยุโรป (EU) กำหนดให้ต้องแสดงการเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ปลายทางใน EU และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน EU ดังนั้น คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU สำหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API

21 เมษายน 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• campaign แหล่งข้อมูลใหม่นี้แสดงถึงแคมเปญของเจ้าของเนื้อหาที่เฉพาะเจาะจง ซึ่งช่วยให้เจ้าของเนื้อหาสามารถใช้คำอธิบายประกอบเพื่อโปรโมตเนื้อหาในวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ เช่น เจ้าของเนื้อหาสามารถสร้างแคมเปญที่เพิ่มลิงก์ไปยังหน้าดูวิดีโอของภาพยนตร์สำหรับวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ที่มีฉากจากภาพยนตร์เรื่องนั้น

  API รองรับวิธีการในการget, list, insert, update, patch และ delete ทรัพยากร campaign

• API รองรับข้อผิดพลาดใหม่หลายรายการสำหรับเมธอด campaigns.get, campaigns.insert, campaigns.update และ campaigns.delete ใหม่

30 มีนาคม 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • assetSearch.list พารามิเตอร์ isrcs ใหม่ของเมธอดช่วยให้คุณระบุรายการ ISRC ได้สูงสุด 50 รายการ การตอบกลับของ API จะมีเนื้อหาที่เชื่อมโยงกับ ISRC เหล่านั้น

  • พร็อพเพอร์ตี้ event[].reason ของทรัพยากร claimHistory รองรับค่าใหม่ต่อไปนี้ เหตุผลแต่ละข้อจะอธิบายว่าเหตุใดจึงเกิดเหตุการณ์ที่เกี่ยวข้องกับการอ้างสิทธิ์นั้นๆ

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • พารามิเตอร์ sort ใหม่ของเมธอด claimSearch.list จะระบุเมธอดที่จะใช้ในการจัดเรียงทรัพยากรในการตอบกลับของ API โดยค่าเริ่มต้น ระบบจะจัดเรียงทรัพยากรตามลำดับเวลาแบบย้อนกลับ (จากใหม่สุดไปเก่าสุด) ตามวันที่สร้าง นอกจากนี้ คุณยังจัดเรียงแหล่งข้อมูลจากจำนวนการดูสูงสุดไปต่ำสุดสำหรับเนื้อหาที่มีการอ้างสิทธิ์ได้ด้วย

    โปรดทราบว่าหากคำขอ claimSearch.list ตั้งค่าพารามิเตอร์ status เป็น appealed, disputed, pending, potential หรือ routedForReview ระบบจะจัดเรียงผลลัพธ์ตามเวลาที่ระยะเวลาการตรวจสอบการอ้างสิทธิ์หมดอายุ

  • ตอนนี้เมธอด ownership.update และ ownership.patch แสดงรายการพร็อพเพอร์ตี้ทั้งหมดที่อัปเดตได้เมื่อเรียกใช้เมธอดเหล่านี้อย่างถูกต้องแล้ว การเปลี่ยนแปลงนี้เป็นการแก้ไขเอกสารประกอบ API และไม่ได้ระบุการเปลี่ยนแปลงฟังก์ชันการทำงานของ API

  • ตอนนี้พารามิเตอร์ fetchMatchPolicy สำหรับเมธอด assets.get และ assets.list แสดง effective เป็นค่าที่รองรับแล้ว ค่านี้จะสั่งให้เซิร์ฟเวอร์ API ดึงนโยบายการจับคู่ที่ YouTube ใช้กับเนื้อหา

  • ตอนนี้พารามิเตอร์ id สำหรับเมธอด assets.list, claims.list, contentOwners.list, policies.list, publishers.list และ references.list ทั้งหมดระบุว่าค่าพารามิเตอร์มีรหัสที่คั่นด้วยคอมมาได้สูงสุด 50 รายการ

• ข้อผิดพลาดใหม่และที่อัปเดต

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

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

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  badRequest (400)	tooManyIsrcs	assetSearch.list เมธอดจะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ isrcs ระบุ ISRC มากกว่า 50 รายการ
  badRequest (400)	videoIsPrivate	claims.insert เมธอดจะแสดงข้อผิดพลาดนี้หากคุณพยายามอ้างสิทธิ์วิดีโอส่วนตัว คุณจะอ้างสิทธิ์วิดีโอได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็นpublicหรือunlistedเท่านั้น
  notModified (304)	blockOutsideOwnershipUnchanged	เมธอด claims.update จะแสดงข้อผิดพลาดนี้หากแก้ไขแฟล็ก blockOutsideOwnership ในการอ้างสิทธิ์ไม่สำเร็จ ข้อผิดพลาดนี้อาจเกิดขึ้นได้จากหลายสาเหตุ ตัวอย่างที่พบบ่อยคือการแก้ไขที่ระบุไม่มีผลกับวิดีโอที่อ้างสิทธิ์

7 พฤศจิกายน 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • ตอนนี้พารามิเตอร์ status ของเมธอด claimSearch.list รองรับค่า routedForReview แล้ว ค่านี้จะจำกัดผลลัพธ์ให้แสดงเฉพาะการอ้างสิทธิ์ที่ต้องตรวจสอบด้วยตนเองตามกฎในนโยบายการจับคู่ของชิ้นงาน

  • พร็อพเพอร์ตี้ event[].reason ของทรัพยากร claimHistory รองรับค่าใหม่ต่อไปนี้ เหตุผลแต่ละข้อจะอธิบายว่าเหตุใดจึงเกิดเหตุการณ์ที่เกี่ยวข้องกับการอ้างสิทธิ์นั้นๆ

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • พร็อพเพอร์ตี้ origin.source ของทรัพยากร claim ซึ่งระบุแหล่งที่มาของการอ้างสิทธิ์ รองรับค่า melodyMatch แล้ว การอ้างสิทธิ์การจับคู่ทำนองระบุว่าวิดีโอที่มีการอ้างสิทธิ์ใช้การเรียบเรียงเพลงร่วมกับข้อมูลอ้างอิง

  • เราได้อัปเดตเอกสารประกอบของreferences.insertเมธอดเพื่อให้แสดงอย่างถูกต้องว่า API ใช้ปลายทาง 2 แบบที่แตกต่างกันสำหรับเมธอดนั้น การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันการทำงานของ API แต่เป็นการแก้ไขเอกสารที่มีอยู่

    • หากคำขอเป็นการอัปโหลดไฟล์อ้างอิงใหม่ ปลายทางที่ถูกต้องคือ

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • หากคำขอเป็นการสร้างข้อมูลอ้างอิงโดยใช้วิดีโอที่อ้างสิทธิ์เป็นเนื้อหาอ้างอิง จุดสิ้นสุดที่ถูกต้องคือ

      POST https://www.googleapis.com/youtube/partner/v1/references

• ข้อผิดพลาดใหม่และที่อัปเดต

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

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

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  badRequest (400)	invalidLabelName	เมธอด assets.insert, assets.update และ assetLabels.insert จะแสดงข้อผิดพลาดนี้หากชื่อป้ายกำกับของชิ้นงานไม่ถูกต้อง ชื่อป้ายกำกับต้องมีความยาวระหว่าง 2 ถึง 30 อักขระ แต่จะต้องไม่มีวงเล็บมุม (< >) คอมมา (,) โคลอน (:) เครื่องหมายและ (&) หรืออักขระไปป์แนวตั้ง (|)
  badRequest (400)	ownerHaveMaximumNumberOfLabels	เมธอด assets.insert, assets.update และ assetLabels.insert จะแสดงข้อผิดพลาดนี้หากเจ้าของเนื้อหากำหนดป้ายกำกับเนื้อหาที่ไม่ซ้ำกัน 2,500 รายการแล้ว ซึ่งเป็นจำนวนสูงสุดที่อนุญาตในปัจจุบัน
  badRequest (400)	tooManyLabelsOnOneAsset	เมธอด assets.insert และ assets.update จะแสดงข้อผิดพลาดนี้หากชิ้นงานเชื่อมโยงกับป้ายกำกับเนื้อหา 30 รายการอยู่แล้ว ซึ่งเป็นจำนวนสูงสุดที่อนุญาตในปัจจุบัน
  badRequest (400)	channelMonetizationSuspended	เมธอด claims.insert และ claims.update จะแสดงข้อผิดพลาดนี้หากช่องของวิดีโอถูกระงับเนื่องจากการอ้างสิทธิ์ของพาร์ทเนอร์
  badRequest (400)	channelNotActive	เมธอด claims.update จะแสดงข้อผิดพลาดนี้หากช่องของวิดีโอไม่ทำงาน

• เมธอด assets.insert และ assets.update จะไม่แสดงข้อผิดพลาด badRequest สำหรับชิ้นงานบางรายการอีกต่อไป หากทรัพยากรในเนื้อหาคำขอไม่มีพร็อพเพอร์ตี้ metadataMine.contentType

23 กันยายน 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การเปลี่ยนแปลงรหัสเจ้าของเนื้อหา

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

  การเปลี่ยนแปลงนี้จะส่งผลต่อฟังก์ชันการทำงานของ API ต่อไปนี้ และอาจส่งผลต่อพาร์ทเนอร์ที่เขียนโค้ดรหัสพาร์ทเนอร์ในแอปพลิเคชันของตน

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

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • พารามิเตอร์ metadataSearchFields ใหม่ของเมธอด assetSearch.list ช่วยให้คุณระบุช่องข้อมูลเมตาของเนื้อหาที่ต้องการค้นหา รวมถึงค่าที่ต้องการค้นหาในช่องเหล่านั้นได้ ค่าพารามิเตอร์คือรายการที่คั่นด้วยคอมมาของคู่ฟิลด์และค่า โดยในคู่หนึ่งๆ ฟิลด์และค่าจะคั่นด้วยโคลอน

  • ออบเจ็กต์ appliedPolicy ใหม่ของclaimทรัพยากรจะระบุนโยบายที่ YouTube ใช้จริงสำหรับการอ้างสิทธิ์ ค่าของออบเจ็กต์คือทรัพยากร policy แหล่งข้อมูลดังกล่าวมีข้อมูลนโยบายสำหรับประเทศที่เจ้าของเนื้อหาซึ่งส่งคำขอเป็นเจ้าของชิ้นงานที่อ้างสิทธิ์

    นโยบายที่บังคับใช้อาจแตกต่างจากนโยบายที่เจ้าของเนื้อหากำหนดไว้ได้ 2 วิธีดังนี้

    1. โดยจะพิจารณานโยบายที่เจ้าของรายอื่นซึ่งเป็นเจ้าของเนื้อหาที่อ้างสิทธิ์บางส่วนในบางประเทศเดียวกันกับเจ้าของเนื้อหาที่ส่งคำขอ API ได้กำหนดไว้

    2. โดยจะพิจารณานโยบายด้านการดูแลระบบของ YouTube ที่มีผลบังคับใช้ในเขตแดนที่เจ้าของเนื้อหาเป็นเจ้าของเนื้อหาที่อ้างสิทธิ์

  • พร็อพเพอร์ตี้ uploaderChannelId ใหม่ของclaimHistoryทรัพยากรจะระบุรหัสช่องของช่องที่อัปโหลดวิดีโอที่อ้างสิทธิ์

8 กันยายน 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

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

    • เมธอด assetLabels.list ช่วยให้คุณดึงข้อมูลรายการป้ายกำกับของเจ้าของเนื้อหาได้
    • assetLabels.insert วิธีนี้ช่วยให้คุณสร้างป้ายกำกับเนื้อหาใหม่ได้ นอกจากนี้ คุณยังสร้างป้ายกำกับใหม่ได้โดยการเรียกใช้เมธอด assets.update และอัปเดตป้ายกำกับสำหรับเนื้อหา เซิร์ฟเวอร์ API จะสร้างทรัพยากร assetLabel ใหม่โดยอัตโนมัติสำหรับป้ายกำกับที่ไม่ได้กำหนดไว้ก่อนหน้านี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • เราได้อัปเดตพร็อพเพอร์ตี้ label[] ของทรัพยากร asset เพื่อระบุว่าคุณสามารถเรียกใช้เมธอด assets.update เพื่ออัปเดตป้ายกำกับของเนื้อหาได้ อย่างไรก็ตาม คุณไม่สามารถตั้งค่าป้ายกำกับของชิ้นงานเมื่อเรียกใช้เมธอด assets.insert ได้

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

• ข้อผิดพลาดใหม่และที่อัปเดต

  API รองรับข้อผิดพลาดใหม่หลายรายการสำหรับเมธอด assetLabels.list และ assetLabels.insert ใหม่

9 กรกฎาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การเปลี่ยนแปลงรหัสเจ้าของเนื้อหา

  ในอดีต API ใช้รหัสพาร์ทเนอร์ที่มนุษย์อ่านได้ เช่น "qrs_network" เพื่อระบุเจ้าของเนื้อหาที่เชื่อมโยงกับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือทรัพยากรที่จัดการผ่าน API โดยไม่ซ้ำกัน ในไตรมาสที่ 3 ปี 2014 API จะเปลี่ยนไปใช้รหัส 22 อักขระที่ไม่ซ้ำกันเพื่อระบุเจ้าของเนื้อหาแทน การเปลี่ยนแปลงนี้จะส่งผลต่อฟังก์ชันการทำงานของ API ต่อไปนี้ และอาจส่งผลต่อพาร์ทเนอร์ที่ฮาร์ดโค้ดรหัสพาร์ทเนอร์ในแอปพลิเคชัน

  • API จะแสดงผลรหัส 22 อักขระเป็นค่าของพร็อพเพอร์ตี้ทรัพยากรที่ก่อนหน้านี้แสดงผลรหัสพาร์ทเนอร์ เช่น พร็อพเพอร์ตี้ id ของทรัพยากร contentOwner
  • เมธอดทั้งหมดของ API รองรับพารามิเตอร์ onBehalfOfContentOwner ซึ่งระบุเจ้าของเนื้อหาที่ส่งคำขอ API ในนามของเจ้าของเนื้อหา หลังจากการเปลี่ยนแปลง คุณควรตั้งค่าพารามิเตอร์เป็นรหัส 22 อักขระแทนรหัสพาร์ทเนอร์ พารามิเตอร์จะยอมรับค่าใดค่าหนึ่งในช่วงระยะเวลาการเปลี่ยนผ่านเพื่อป้องกันไม่ให้โค้ดหยุดทำงาน
  • หลังจากการเปลี่ยนแปลง พารามิเตอร์ contentOwnerId ของเมธอด contentOwners.list ควรระบุรหัส 22 อักขระแทนรหัสพาร์ทเนอร์

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

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

  • ตอนนี้เมธอด assetSearch.list รองรับพารามิเตอร์ที่ไม่บังคับต่อไปนี้แล้ว

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

  • ตอนนี้ทรัพยากร claimHistory มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    • event[].source.userEmail พร็อพเพอร์ตี้ระบุอีเมลของผู้ใช้ที่เริ่มกิจกรรม
    • พร็อพเพอร์ตี้ event[].typeDetails.disputeNotes มีหมายเหตุการโต้แย้งสำหรับเหตุการณ์ dispute_create

  • ตอนนี้เมธอด claimSearch.list รองรับพารามิเตอร์ที่ไม่บังคับต่อไปนี้แล้ว

    • createdAfter: จำกัดผลลัพธ์ให้รวมเฉพาะการอ้างสิทธิ์ที่สร้างขึ้นหลังจากวันที่ที่ระบุ
    • createdBefore: จำกัดผลลัพธ์ให้รวมเฉพาะการอ้างสิทธิ์ที่สร้างขึ้นก่อนวันที่ที่ระบุ
    • includeThirdPartyClaims: พารามิเตอร์นี้ใช้ร่วมกับพารามิเตอร์ videoId เพื่อระบุว่าจะรวมการอ้างสิทธิ์ของบุคคลที่สามไว้ในผลลัพธ์ของ API หรือไม่

• ข้อมูลข้อผิดพลาดโดยละเอียดเพิ่มเติม

  ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดระบุรหัสการตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภทแล้ว

• ข้อผิดพลาดใหม่และที่อัปเดต

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

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

  วิธีการ	ข้อผิดพลาด
  assetSearch.list	invalidValue - API ไม่รองรับความสามารถในการค้นหาสื่อของรายการหรือซีซัน เปลี่ยนค่าของพารามิเตอร์ type เป็นค่าที่รองรับ
  assets.insert	conflict - มีเนื้อหาจำนวนมากเกินไปที่มีตัวระบุเดียวกันอยู่แล้ว (เช่น รหัสที่กำหนดเอง, ISRC ฯลฯ) conflict – มีสำเนาของชิ้นงานที่ระบุมากเกินไปแล้ว invalidValue - ผู้ใช้ที่เรียกใช้ API ไม่มีสิทธิ์สร้างชิ้นงานประเภทที่ระบุ
  assets.patch assets.update	badRequest – API ไม่รองรับการแปลงประเภทชิ้นงานที่คุณพยายามดำเนินการ
  claimSearch.list	badRequest – พารามิเตอร์ includeThirdPartyClaims ใช้ร่วมกับตัวกรอง videoId ได้เท่านั้น
  ownership.patch ownership.update	badRequest - คุณอัปเดตความเป็นเจ้าของเนื้อหาแทร็กภาพไม่ได้
  references.patch references.update	badRequest – ข้อมูลอ้างอิงอยู่ในสถานะที่ไม่ถูกต้องสำหรับการดำเนินการที่คุณพยายามทำ

3 กุมภาพันธ์ 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • ตอนนี้assetสามารถมีค่า type เป็น art_track_video ได้แล้ว

  • ตอนนี้ทรัพยากร claimSearch มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

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

  • ตอนนี้เมธอด claimSearch.list รองรับพารามิเตอร์ที่ไม่บังคับต่อไปนี้แล้ว

    • contentType: จำกัดผลการค้นหาให้รวมเฉพาะการอ้างสิทธิ์เสียงเท่านั้น การอ้างสิทธิ์วิดีโอเท่านั้น หรือการอ้างสิทธิ์ภาพและเสียง
    • origin: ระบุแหล่งที่มาของการอ้างสิทธิ์อย่างน้อย 1 รายการ เช่น descriptiveSearch หรือ videoMatch ที่คุณต้องการค้นหาการอ้างสิทธิ์
    • status: จำกัดผลการค้นหาให้แสดงเฉพาะการอ้างสิทธิ์ที่มีสถานะที่ระบุ

  • ตอนนี้พร็อพเพอร์ตี้ status ของทรัพยากร claim รองรับค่าเพิ่มเติมต่อไปนี้แล้ว appealed, disputed, potential, takedown และ unknown

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

  • พร็อพเพอร์ตี้ allowedOptions.autoGeneratedBreaks ใหม่ของทรัพยากร contentOwnerAdvertisingOption จะระบุว่าพาร์ทเนอร์เลือกแสดงโฆษณาตอนกลางและโฆษณาในสตรีมในช่วงพักที่ YouTube กำหนดโดยอัตโนมัติได้หรือไม่

  • ตอนนี้คุณเรียกใช้เมธอด contentOwners.list ได้แล้วด้วยโทเค็นการให้สิทธิ์ที่ระบุขอบเขต https://www.googleapis.com/auth/youtubepartner-content-owner-readonly

  • พร็อพเพอร์ตี้ timeUpdated ใหม่ของทรัพยากร policy จะระบุเวลาที่อัปเดตนโยบายครั้งล่าสุด

  • ตอนนี้เมธอด policies.list รองรับพารามิเตอร์ sort ที่ไม่บังคับแล้ว ซึ่งสามารถใช้เพื่อระบุว่าควรจัดเรียงผลลัพธ์ตามลำดับเวลาที่อัปเดตล่าสุดจากน้อยไปมากหรือจากมากไปน้อย

  • พร็อพเพอร์ตี้ expiryTime ใหม่ของreferenceConflictทรัพยากรจะระบุเวลาที่ระยะเวลาตรวจสอบความขัดแย้งอ้างอิงจะสิ้นสุดลง ซึ่งจะทำให้ความขัดแย้งหมดอายุ

  • พร็อพเพอร์ตี้ autoGeneratedBreaks ใหม่ของvideoAdvertisingOptionทรัพยากรจะระบุว่าวิดีโอควรแสดงโฆษณาตอนกลางและโฆษณาในสตรีมในช่วงพักที่ YouTube กำหนดโดยอัตโนมัติหรือไม่

• ข้อผิดพลาดใหม่และที่อัปเดต

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

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

  วิธีการ	ข้อผิดพลาด
  assets.insert assets.update	badRequest - API ไม่รองรับการดำเนินการเขียนในเนื้อหาแทร็กภาพ
  claimSearch.list	invalidValue - พารามิเตอร์ pageToken ในคำขอระบุโทเค็นหน้าเว็บที่ไม่ถูกต้อง
  claims.insert	badRequest – การอ้างสิทธิ์ที่คุณพยายามสร้างไม่ถูกต้องเนื่องจากช่องของวิดีโอไม่ได้ใช้งาน badRequest – วิดีโอที่คุณพยายามอ้างสิทธิ์ได้รับการยกเว้นจากนโยบายการลบออก หากมีข้อสงสัย โปรดติดต่อ [e-mail] badRequest – เราดำเนินการตามคำขอของคุณไม่ได้เนื่องจากคุณสร้างการอ้างสิทธิ์โดยบุคคลที่สามในวิดีโอที่ระบุไม่ได้ conflict – YouTube สร้างการอ้างสิทธิ์ตามคำขอไม่ได้เนื่องจากวิดีโอได้โต้แย้งการแจ้งเพื่อให้ลบออก conflict – YouTube ไม่สามารถสร้างการอ้างสิทธิ์ตามคำขอได้เนื่องจากวิดีโอมีการอ้างสิทธิ์ที่ส่งคำขอให้ลบออกที่ยังใช้งานอยู่
  references.insert	badRequest – วิดีโอที่มีการอ้างสิทธิ์ที่คุณพยายามใช้ถูกลบหรือถูกปฏิเสธ หรือการประมวลผลล้มเหลว

• ข้อผิดพลาด contentOwnerNotProvided และ internalError ซึ่งไม่ได้เจาะจงวิธีการ API ใดวิธีการหนึ่งจะไม่แสดงในหน้าวิธีการทุกหน้าอีกต่อไป คุณยังดูคำอธิบายได้ในส่วนข้อผิดพลาดทั่วไปของเอกสารข้อผิดพลาดของ API

12 กันยายน 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • referenceConflictใหม่จะระบุความขัดแย้งระหว่างไฟล์อ้างอิง 2 ไฟล์ และแสดงรายการการจับคู่ที่อยู่ระหว่างไฟล์เหล่านั้นเมื่อพบความขัดแย้ง referenceConflicts.list วิธีนี้ช่วยให้คุณดึงรายการความขัดแย้งของการอ้างอิงที่ยังไม่ได้รับการแก้ไขซึ่งเชื่อมโยงกับเจ้าของเนื้อหาที่ได้รับอนุญาตได้ เมธอด referenceConflicts.get ช่วยให้คุณดึงข้อมูลความขัดแย้งในการอ้างอิงได้โดยการระบุรหัสความขัดแย้งในการอ้างอิงที่ไม่ซ้ำกัน

  การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

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

    หากต้องการดึงนโยบายการจับคู่ที่มีผลสำหรับชิ้นงาน ให้ตั้งค่าพารามิเตอร์ fetchMatchPolicy เป็น effective เมื่อเรียกใช้เมธอด assets.get หรือ assets.list ในคำตอบของ API ออบเจ็กต์ matchPolicyEffective ในทรัพยากร asset ที่ส่งคืนแต่ละรายการจะมีนโยบายการจับคู่ที่มีผลสำหรับเนื้อหานั้น

  • ออบเจ็กต์ ownershipConflicts ใหม่ของทรัพยากร asset มีข้อมูลเกี่ยวกับความขัดแย้งในการเป็นเจ้าของเนื้อหา โครงสร้างของออบเจ็กต์คล้ายกับโครงสร้างของทรัพยากร ownership ซึ่งระบุสิทธิ์แต่ละประเภทที่เจ้าของเนื้อหามีได้ (สำหรับเนื้อหาส่วนใหญ่ เจ้าของมีเพียงความเป็นเจ้าของเนื้อหาทั่วไป แต่สำหรับเนื้อหาการเรียบเรียงเพลง เจ้าของสามารถระบุความเป็นเจ้าของสิทธิ์ในการนำเพลงไปใช้แสดง สิทธิ์ในการซิงค์ หรือสิทธิ์ในการทำซ้ำในรูปของสิ่งบันทึกเสียงได้)

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

  • ตอนนี้เมธอด assets.get และ assets.get รองรับพารามิเตอร์ fetchOwnershipConflicts ใหม่แล้ว พารามิเตอร์มีค่าบูลีนที่ระบุว่าคำขอ API ควรดึงความขัดแย้งในการเป็นเจ้าของเนื้อหาในคำตอบ API หรือไม่ ค่าเริ่มต้นคือ false ซึ่งหมายความว่าจะไม่มีการแสดงผลการขัดกันของความเป็นเจ้าของ

  • เราได้อัปเดตคำจำกัดความของพารามิเตอร์ q ของเมธอด assetSearch.list เพื่อระบุฟิลด์ข้อมูลเมตาที่ YouTube ค้นหา

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

• ข้อผิดพลาดใหม่และที่อัปเดต

  • API รองรับforbiddenข้อผิดพลาดใหม่ ซึ่งไม่ได้เจาะจงเมธอดใดเมธอดหนึ่ง และบ่งชี้ว่าบัญชีบริการไม่สามารถให้สิทธิ์การดำเนินการที่ขอได้

  • ตอนนี้ assets.insert เมธอดจะระบุข้อผิดพลาดของข้อมูลเมตาว่าเกิดขึ้นในพร็อพเพอร์ตี้ในออบเจ็กต์ metadataMine แทนที่จะเป็นในออบเจ็กต์ metadata ซึ่งเลิกใช้งานแล้วตั้งแต่การอัปเดต API เมื่อวันที่ 16 กรกฎาคม 2013

  • หน้าข้อผิดพลาดได้รับการอัปเดตเพื่อให้สำหรับแต่ละแหล่งข้อมูลที่รองรับเมธอด update และ patch หน้าดังกล่าวจะมีตาราง 1 ตารางที่แสดงข้อผิดพลาดที่เมธอดทั้ง 2 ส่งคืน ก่อนหน้านี้ หน้าเว็บจะแสดงข้อผิดพลาดสำหรับแต่ละวิธีแยกกัน แม้ว่ารายการจะเหมือนกันเสมอ

16 กรกฎาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• แหล่งข้อมูลและวิธีการใหม่ๆ

  • วิธี claimHistory.get ใหม่ช่วยให้คุณระบุและดึงข้อมูลเกี่ยวกับการอ้างสิทธิ์ที่เฉพาะเจาะจงได้ claimHistory ทรัพยากรที่ส่งคืนจะมีรายการเหตุการณ์ที่เกี่ยวข้องกับการอ้างสิทธิ์ เช่น การสร้าง อัปเดต โต้แย้ง หรือปิดการอ้างสิทธิ์

  • claimSearch.list วิธีใหม่นี้ช่วยให้คุณค้นหาการอ้างสิทธิ์ที่ตรงตามเกณฑ์ต่อไปนี้บางส่วนหรือทั้งหมดได้

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

    ทรัพยากร claimSnippet แต่ละรายการในการตอบกลับของ API จะมีรายละเอียดเกี่ยวกับการอ้างสิทธิ์ รวมถึงรหัสการอ้างสิทธิ์ที่ไม่ซ้ำกัน สถานะ ประเภท (audio, video หรือ audiovisual) ตลอดจนชิ้นงานและวิดีโอที่เชื่อมโยงกับการอ้างสิทธิ์ นอกจากนี้ ทรัพยากรยังระบุจำนวนยอดดูและชื่อของวิดีโอที่อ้างสิทธิ์ด้วย

• การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

  • ตอนนี้เอกสารประกอบแสดงค่าที่รองรับสำหรับพร็อพเพอร์ตี้ที่มีชุดค่าที่แจกแจงไว้แล้ว พร็อพเพอร์ตี้ดังกล่าวรวมถึงพร็อพเพอร์ตี้ type ของทรัพยากร asset และพร็อพเพอร์ตี้ status ของทรัพยากร claim

  • สำหรับเมธอด assets.get และ assets.list ตอนนี้ API รองรับค่าที่คั่นด้วยคอมมาสำหรับพารามิเตอร์คำขอ fetchMetadata และ fetchOwnership แล้ว ซึ่งช่วยให้คุณดึงข้อมูลเมตาหรือข้อมูลการเป็นเจ้าของหลายชุดได้

    รายการด้านล่างอธิบายการเปลี่ยนแปลงที่เกี่ยวข้องกับโครงสร้างของทรัพยากร asset รวมถึงผลกระทบของการเปลี่ยนแปลงเหล่านั้นต่อเมธอด API ที่ get, list, insert, update หรือ patch ทรัพยากร asset

    • metadata เลิกใช้งานออบเจ็กต์แล้วและแทนที่ด้วยออบเจ็กต์ metadataMine และ metadataEffective ออบเจ็กต์ใหม่ช่วยให้assetทรัพยากรรวมทั้งชุดข้อมูลเมตาที่เจ้าของเนื้อหาซึ่งส่งคำขอ API ระบุไว้ รวมถึงชุดข้อมูลเมตาตามรูปแบบบัญญัติที่ YouTube ระบุว่าเป็นชุดข้อมูลเมตาที่แม่นยำและครบถ้วนที่สุดสำหรับเนื้อหา

    • ในทำนองเดียวกัน เราได้แทนที่ออบเจ็กต์ ownership ด้วยออบเจ็กต์ ownershipMine และ ownershipEffective

    • ออบเจ็กต์ matchPolicy ถูกแทนที่ด้วยออบเจ็กต์ matchPolicyMine แล้ว (ขณะนี้ API ยังไม่รองรับความสามารถในการดึงนโยบายการจับคู่ที่มีผลสำหรับชิ้นงาน)

    หมายเหตุ: เพื่อให้มั่นใจว่าสามารถใช้งานร่วมกับเวอร์ชันก่อนหน้าได้ หากมีการขอข้อมูลเมตาเพียงเวอร์ชันเดียว ชุดข้อมูลการเป็นเจ้าของชุดเดียว หรือนโยบายการจับคู่เดียวสำหรับเนื้อหา การตอบกลับของ API จะมีทั้งออบเจ็กต์ที่เลิกใช้งานแล้วและออบเจ็กต์ที่รองรับใหม่ ตัวอย่างเช่น หากคำขอตั้งค่าพารามิเตอร์ fetchMetadata เป็น mine การตอบกลับ API จะมีออบเจ็กต์ metadata และออบเจ็กต์ metadataMine ซึ่งทั้ง 2 ออบเจ็กต์จะมีข้อมูลเดียวกัน (ความสามารถในการตั้งค่า fetchMetadata=mine ได้รับการรองรับก่อนการอัปเดตฟีเจอร์ที่ช่วยให้คุณดึงข้อมูลเวอร์ชันข้อมูลเมตาหลายรายการได้)
    
    อย่างไรก็ตาม หากตั้งค่าพารามิเตอร์ fetchMetadata เป็น mine,effective การตอบกลับของ API จะมีออบเจ็กต์ metadataMine และ metadataEffective แต่จะไม่มีออบเจ็กต์ metadata (ความสามารถในการตั้งค่า fetchMetadata=mine,effective ไม่ได้รับการรองรับก่อนการอัปเดตฟีเจอร์นี้ จึงไม่จำเป็นต้องส่งคืนออบเจ็กต์ metadata เพื่อความเข้ากันได้แบบย้อนหลัง) หลักการเดียวกันนี้ยังใช้กับพารามิเตอร์ fetchOwnership และ fetchMatchPolicy ด้วย
    
    ในทำนองเดียวกัน เพื่อให้มีความเข้ากันได้แบบย้อนหลัง คำขอไปยัง insert, update หรือ patch ของทรัพยากร asset สามารถรวมออบเจ็กต์ metadataMine หรือออบเจ็กต์ metadata ก็ได้ หลักการเดียวกันนี้ใช้กับการตั้งค่าassetข้อมูลการเป็นเจ้าของหรือนโยบายการจับคู่ของทรัพยากร

  • เราเลิกใช้งานพารามิเตอร์ assetId, q และ videoId ของเมธอด claims.list แล้ว หากต้องการค้นหาการอ้างสิทธิ์โดยใช้เกณฑ์ใดเกณฑ์หนึ่งเหล่านี้ ให้ใช้วิธี claimSearch.list ซึ่งรองรับพารามิเตอร์ทั้งหมดดังกล่าว

  • ในทรัพยากร ownership ค่าของพร็อพเพอร์ตี้ general[].ratio, performance[].ratio, synchronization[].ratio และ mechanical[].ratio ทั้งหมดจะมีรูปแบบเนื้อหาเป็น double แทน integer

  • ตอนนี้คำจำกัดความของพร็อพเพอร์ตี้ rules[].action ของทรัพยากร policy แสดงค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นั้นแล้ว ได้แก่ block, monetize, takedown และ track อย่างไรก็ตาม โปรดทราบว่าคุณไม่สามารถใช้ API เพื่อใช้นโยบายการลบออกตามคำขอให้ลบออกกับคำกล่าวอ้าง

  • referenceclaimIdพร็อพเพอร์ตี้ใหม่ของทรัพยากรจะปรากฏขึ้นหากมีการสร้างข้อมูลอ้างอิงโดยการเชื่อมโยงเนื้อหากับวิดีโอ YouTube ที่มีอยู่ซึ่งอัปโหลดไปยังช่อง YouTube ที่ลิงก์กับบัญชี CMS ของคุณ ในกรณีดังกล่าว ฟิลด์นี้จะมีรหัสของการอ้างสิทธิ์ที่แสดงถึงความเชื่อมโยงระหว่างเนื้อหากับวิดีโอ

  • พร็อพเพอร์ตี้ excludedIntervals[] ใหม่ของแหล่งข้อมูล reference จะระบุรายการช่วงเวลาในข้อมูลอ้างอิงที่ YouTube ควรละเว้นเมื่อพยายามจับคู่ข้อมูลอ้างอิง แต่ละช่วงเวลาจะระบุเวลาเริ่มต้นและเวลาสิ้นสุดที่วัดเป็นวินาทีนับจากจุดเริ่มต้นของวิดีโอ

  • API ไม่กำหนดให้ตั้งค่าพร็อพเพอร์ตี้ status ในทรัพยากร reference ที่ส่งในส่วนเนื้อหาของคำขอ references.update หรือ references.patch อีกต่อไป

  • เราได้แก้ไขเอกสารประกอบเพื่ออธิบายรูปแบบการตอบกลับของ API สำหรับเมธอด videoAdvertisingOptions.getEnabledAds อย่างถูกต้องแล้ว การตอบกลับซึ่งเป็นyoutubePartner#videoAdvertisingOptionGetEnabledAdsทรัพยากรจะมีข้อมูลต่อไปนี้

    • id - รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่อ้างสิทธิ์ซึ่งเชื่อมโยงกับการตั้งค่า

    • adBreaks – รายการออบเจ็กต์ซึ่งแต่ละออบเจ็กต์มีข้อมูลเกี่ยวกับจุดก่อน ระหว่าง หรือหลังการเล่นวิดีโอเมื่ออนุญาตให้โฆษณาทำงาน นอกจากนี้ ออบเจ็กต์แต่ละรายการยังระบุแอตทริบิวต์อื่นๆ ของช่วงพักโฆษณาได้ด้วย เช่น ช่องโฆษณาที่เกิดขึ้นในช่วงพักและประเภทโฆษณาที่ได้รับอนุญาตให้แสดงในแต่ละช่อง

    • adsOnEmbeds - ฟิลด์บูลีนที่ระบุว่า YouTube สามารถแสดงโฆษณาเมื่อเล่นวิดีโอในเพลเยอร์แบบฝังได้หรือไม่

    • countriesRestriction - รายการออบเจ็กต์ซึ่งแต่ละออบเจ็กต์จะระบุรายการเขตแดนและรูปแบบโฆษณาที่ใช้ในระหว่างการเล่นวิดีโอในเขตแดนเหล่านั้น

• ข้อผิดพลาดใหม่และที่อัปเดต

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

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

    วิธีการ	ข้อผิดพลาด
    assets.insert assets.update assets.patch	ข้อผิดพลาด invalidValue และ required ที่เชื่อมโยงกับพร็อพเพอร์ตี้ย่อยของออบเจ็กต์ metadata ก่อนหน้านี้จะเชื่อมโยงกับพร็อพเพอร์ตี้ย่อยเดียวกันในออบเจ็กต์ metadataMine
    claimHistory.get	notFound - ไม่พบการอ้างสิทธิ์ที่คุณพยายามดึงประวัติ required - คำขอไม่ได้ระบุค่าสำหรับพารามิเตอร์ claimId
    claimSearch.list claims.list	badRequest - คำขอระบุเกณฑ์ที่ไม่ถูกต้อง ระบุพารามิเตอร์ตัวกรองต่อไปนี้ได้สูงสุด 1 รายการ ได้แก่ q, assetId, videoId
    claims.insert	badRequest – การอ้างสิทธิ์ที่คุณพยายามสร้างไม่ถูกต้องเนื่องจากเจ้าของเนื้อหาที่ขอไม่ใช่เจ้าของเนื้อหาที่เชื่อมโยงกับการอ้างสิทธิ์ badRequest - เจ้าของเนื้อหาที่คุณดำเนินการในนามไม่มีสิทธิ์สร้างนโยบายที่มีการดำเนินการที่ระบุ invalidValue – เจ้าของเนื้อหาที่คุณดำเนินการในนามไม่มีสิทธิ์อ้างสิทธิ์วิดีโอที่ผู้ใช้อัปโหลดผ่าน API
    contentOwners.list	badRequest - คำขอระบุเกณฑ์ที่ไม่ถูกต้อง ต้องระบุพารามิเตอร์ตัวกรองต่อไปนี้อย่างใดอย่างหนึ่งเท่านั้น ได้แก่ fetchMine, id (ก่อนหน้านี้ ข้อผิดพลาดจะแสดงชุดพารามิเตอร์ตัวกรองที่แตกต่างกัน ได้แก่ has_conflicts_with, restrict_to_user, name_prefix และ id)
    ownership.update ownership.patch	badRequest – คำขอที่อัปเดตข้อมูลความเป็นเจ้าของของชิ้นงานเพลงต้องระบุข้อมูลความเป็นเจ้าของแบบละเอียด ซึ่งได้แก่ สิทธิ์mechanical, performance, synchronization และ/หรือ lyric แทนที่จะเป็นสิทธิ์ความเป็นเจ้าของgeneral ระบบรองรับสิทธิ์ประเภท lyric แล้ว
    policies.insert policies.update policies.patch	invalidValue – คำขอมีกฎนโยบายที่ไม่ถูกต้องเนื่องจาก API ไม่รองรับการสร้างหรือแก้ไขนโยบายที่ระบุการดำเนินการ takedown ข้อผิดพลาดนี้ซึ่งรายงานเหตุผลเป็น invalidPolicyTakedownAction จะแทนที่ข้อผิดพลาด invalidPolicyConditionalTakedown ที่เลิกใช้งานแล้ว
    references.insert	badRequest - คำขอต้องส่งไฟล์สื่อหรือระบุค่าสำหรับพารามิเตอร์คำขอ claimId อย่างไรก็ตาม คำขออาจไม่ส่งไฟล์สื่อและระบุค่าสำหรับพารามิเตอร์คำขอ claimId badRequest – มีการสร้างข้อมูลอ้างอิงสำหรับเนื้อหาเดียวกันแล้วจากการอ้างสิทธิ์อื่นในวิดีโอ YouTube เดียวกัน badRequest - API ไม่รองรับความสามารถในการตั้งค่าสำหรับพร็อพเพอร์ตี้ fpDirect เมื่อสร้างการอ้างอิง internalError - ไฟล์สื่อที่อัปโหลดมีปัญหา invalidValue - ค่าของพารามิเตอร์คำขอ contentType, assetId หรือ claimId ไม่ถูกต้อง ข้อผิดพลาดจะระบุค่าที่ไม่ถูกต้อง notFound - ไม่พบชิ้นงานหรือการอ้างสิทธิ์ที่คุณระบุ โปรดตรวจสอบค่าพารามิเตอร์ assetId และ claimId ในคำขอ required - คำขอต้องระบุค่าสำหรับพารามิเตอร์ contentType
    references.insert references.update references.patch	invalidValue - excludedIntervals ที่ระบุสำหรับการอ้างอิงไม่ถูกต้อง โปรดทราบว่าคุณไม่สามารถระบุช่วงการยกเว้นเมื่อปิดใช้งานข้อมูลอ้างอิง

10 พฤษภาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• YouTube จะไม่ระบุฟีเจอร์และบริการ API ที่เป็นเวอร์ชันทดลองอีกต่อไป แต่ตอนนี้เรามีรายการ API ของ YouTube ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน

8 เมษายน 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• เราได้เปลี่ยนชื่อ API เป็น API สำหรับ Content ID ของ YouTube แล้ว

• มีการเปลี่ยนแปลงพร็อพเพอร์ตี้หลายรายการในทรัพยากร assetMatchPolicy ดังนี้

  • มูลค่าพร็อพเพอร์ตี้ kind เปลี่ยนจาก youtubePartner#policy เป็น youtubePartner#assetMatchPolicy
  • พร็อพเพอร์ตี้ policyId ใหม่มีค่าที่ระบุทรัพยากรนโยบายที่บันทึกไว้ได้แบบไม่ซ้ำ
  • ตอนนี้ค่าพร็อพเพอร์ตี้ rules[].subaction เป็นรายการสตริงแทนที่จะเป็นสตริง
  • ตอนนี้ค่าพร็อพเพอร์ตี้ rules[].conditions.contentMatchType เป็นรายการสตริงแทนที่จะเป็นสตริง
  • ระบบได้นำพร็อพเพอร์ตี้ id, name และ description ออกแล้ว

• เอกสารประกอบสำหรับเมธอด assetMatchPolicy.update ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าคุณสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ policyId หรือออบเจ็กต์ rules[] เมื่อเรียกใช้เมธอด

• ตอนนี้claimsรองรับพร็อพเพอร์ตี้ใหม่หลายรายการแล้ว ดังนี้

  ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย
  timeCreated	datetime	วันที่และเวลาที่สร้างการอ้างสิทธิ์
  matchInfo	object	ออบเจ็กต์ matchInfo มีข้อมูลเกี่ยวกับเนื้อหาที่ตรงกันซึ่งทำให้เกิดการอ้างสิทธิ์ ข้อมูลนี้จะรวมอยู่ในclaimทรัพยากรก็ต่อเมื่อระบบสร้างการอ้างสิทธิ์โดยอัตโนมัติเนื่องจากวิดีโอที่อัปโหลดตรงกับไฟล์อ้างอิงที่มีอยู่
  matchInfo.referenceId	string	รหัสที่ไม่ซ้ำกันที่ YouTube ใช้เพื่อระบุข้อมูลอ้างอิง reference ที่สร้างการจับคู่
  matchInfo.longestMatch	object	ออบเจ็กต์ longestMatch มีข้อมูลเกี่ยวกับการจับคู่ที่ตรงกันที่ยาวที่สุดระหว่างข้อมูลอ้างอิงกับวิดีโอที่อัปโหลด
  matchInfo.longestMatch.durationSecs	unsigned long	ระยะเวลาของการแข่งขันเป็นวินาที
  matchInfo.longestMatch.userVideoOffset	unsigned long	ออฟเซ็ตเวลาเมื่อการแข่งขันเริ่มขึ้น โดยวัดเป็นวินาทีนับจากจุดเริ่มต้นของวิดีโอที่อัปโหลด
  matchInfo.longestMatch.referenceOffset	unsigned long	ออฟเซ็ตเวลาเมื่อการแข่งขันเริ่ม โดยวัดเป็นวินาทีนับจากจุดเริ่มต้นของการอ้างอิง
  matchInfo.totalMatch	object	ออบเจ็กต์ totalMatch มีข้อมูลเกี่ยวกับปริมาณทั้งหมดของวิดีโอที่อัปโหลดซึ่งตรงกับข้อมูลอ้างอิง และปริมาณทั้งหมดของข้อมูลอ้างอิงซึ่งตรงกับวิดีโอที่อัปโหลด ค่าเหล่านี้อาจแตกต่างกันหากเนื้อหาที่ตรงกันเล่นซ้ำในวิดีโอที่อัปโหลดหรือข้อมูลอ้างอิง ตัวอย่างเช่น หากวิดีโอที่อัปโหลดมีคลิปยาว 10 วินาทีจากข้อมูลอ้างอิง แต่คลิปดังกล่าวซ้ำกัน 6 ครั้ง เนื้อหาที่ตรงกันทั้งหมดในวิดีโอที่อัปโหลดจะยาว 60 วินาที แต่เนื้อหาที่ตรงกันทั้งหมดในข้อมูลอ้างอิงจะยาวเพียง 10 วินาที
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	ความยาวรวมเป็นวินาทีของเนื้อหาในวิดีโอที่อัปโหลดซึ่งตรงกับไฟล์อ้างอิง
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	ความยาวรวมเป็นวินาทีของเนื้อหาอ้างอิงซึ่งตรงกับวิดีโอที่อัปโหลด
  origin	object	origin ออบเจ็กต์มีข้อมูลที่อธิบายแหล่งที่มาของการอ้างสิทธิ์
  origin.source	string	แหล่งที่มาของคำกล่าวอ้าง

• เราได้อัปเดตพร็อพเพอร์ตี้ policy ในทรัพยากร claims เพื่อระบุว่าอัปเดตค่าสำหรับการอ้างสิทธิ์ AudioSwap ไม่ได้

• เปลี่ยนชื่อพร็อพเพอร์ตี้ timeProvidedMs ของทรัพยากร metadataHistory เป็น timeProvided แล้ว

• เปลี่ยนชื่อพร็อพเพอร์ตี้ timeProvidedMs ของทรัพยากร ownershipHistory เป็น timeProvided แล้ว

• เราได้อัปเดตคำจำกัดความของownershipHistory.listเมธอดเพื่อระบุว่าเมธอดนี้จะดึงข้อมูลความเป็นเจ้าของล่าสุดสำหรับเจ้าของเนื้อหาแต่ละรายเท่านั้น อย่างไรก็ตาม หากเจ้าของเนื้อหาส่งข้อมูลการเป็นเจ้าของผ่านแหล่งข้อมูลหลายแห่ง (API, ฟีดเนื้อหา ฯลฯ) รายการจะมีข้อมูลล่าสุดสำหรับเจ้าของเนื้อหาและแหล่งข้อมูลแต่ละราย

• มีการเปลี่ยนแปลงพร็อพเพอร์ตี้หลายรายการในทรัพยากร policy ดังนี้

  • พร็อพเพอร์ตี้ rule เปลี่ยนชื่อเป็นกฎแล้ว
  • ตอนนี้ค่าพร็อพเพอร์ตี้ rules[].subaction เป็นรายการสตริงแทนที่จะเป็นสตริง
  • ตอนนี้ค่าพร็อพเพอร์ตี้ rules[].conditions.contentMatchType เป็นรายการสตริงแทนที่จะเป็นสตริง

• เอกสารประกอบสำหรับเมธอด policies.insert และ policies.update ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าคุณสามารถตั้งค่าสำหรับออบเจ็กต์ rules[] เมื่อเรียกใช้เมธอดเหล่านั้นได้

• เมธอด API หลายรายการรองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างจะระบุวิธีการและอธิบายโดยย่อถึงประเภทของข้อผิดพลาดที่รองรับใหม่ ในหลายกรณี อาจมีข้อผิดพลาดหลายรายการสำหรับข้อผิดพลาดประเภทหนึ่งๆ เช่น ระบบจะแสดงข้อผิดพลาด required หากคุณพยายามแทรกทรัพยากร asset ที่ไม่มีฟิลด์ข้อมูลเมตาที่จำเป็น ในความเป็นจริง อาจมีฟิลด์ข้อมูลเมตาที่จำเป็นมากกว่า 1 รายการ ซึ่งแต่ละรายการจะแสดงข้อผิดพลาดพร้อมข้อความที่แตกต่างกันเล็กน้อย

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

  วิธีการ	ข้อผิดพลาด
  assets.insert	invalidValue - ฟิลด์ข้อมูลเมตาของเนื้อหามีค่าที่ไม่ถูกต้อง required - ไม่มีช่องข้อมูลเมตาของเนื้อหาที่ต้องกรอก
  assets.update assets.patch	forbidden – พาร์ทเนอร์ที่พยายามอัปเดตไม่ได้เป็นเจ้าของเนื้อหาที่กำลังอัปเดต invalidValue - ฟิลด์ข้อมูลเมตาของเนื้อหามีค่าที่ไม่ถูกต้อง notFound – ระบบกำลังเชื่อมโยงเนื้อหากับเนื้อหาซีซันหรือเนื้อหารายการที่ไม่พบ required - ไม่มีช่องข้อมูลเมตาของเนื้อหาที่ต้องกรอก
  claims.insert	badRequest - คำขอพยายามอ้างสิทธิ์วิดีโอ แต่ไม่อนุญาตให้อ้างสิทธิ์
  ownership.update ownership.patch	badRequest – คำขอระบุการเป็นเจ้าของทั้งหมดมากกว่า 100% ภายในเขตแดน
  policies.insert policies.patch policies.update	conflictingPolicyRules - นโยบายมีกฎนโยบายที่ขัดแย้งกัน

• หน้าข้อผิดพลาดใหม่จะแสดงข้อผิดพลาดที่ API สามารถแสดงได้ หน้านี้มีข้อผิดพลาดทั่วไปซึ่งอาจเกิดขึ้นกับเมธอด API ที่แตกต่างกันหลายรายการ รวมถึงข้อผิดพลาดเฉพาะเมธอด

18 มกราคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

• videoAdvertisingOptions.getEnabledAds วิธีการที่เพิ่งมีการบันทึกช่วยให้คุณดึงรายละเอียดเกี่ยวกับประเภทโฆษณาที่อนุญาตสำหรับวิดีโอที่พาร์ทเนอร์หรือผู้ใช้อัปโหลดที่ระบุได้

• เราได้อัปเดตคำจำกัดความของพารามิเตอร์ ownershipRestriction ของเมธอด assetSearch.list เพื่อระบุว่าค่าพารามิเตอร์เริ่มต้นคือ mine ซึ่งบ่งชี้ว่า API ควรดึงข้อมูลเนื้อหาที่ผู้ใช้ปัจจุบันเป็นเจ้าของเท่านั้น

• เอกสารประกอบของเมธอด assets.list จะแสดงการเปลี่ยนแปลงต่อไปนี้

  • ตอนนี้ต้องระบุพารามิเตอร์ id แล้ว

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

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

  • รายการชิ้นงานที่ API แสดงจะไม่รวมข้อมูลการแบ่งหน้าอีกต่อไป ด้วยเหตุนี้ ระบบจึงนำพร็อพเพอร์ตี้ nextPageToken และออบเจ็กต์ pageInfo ออกจากการตอบกลับของ API ออบเจ็กต์ pageInfo มีพร็อพเพอร์ตี้ totalResults, resultsPerPage และ startIndex

• claimsเอกสารประกอบเกี่ยวกับทรัพยากรได้รับการอัปเดตเพื่อระบุว่าคุณต้องระบุนโยบายเมื่อสร้างการอ้างสิทธิ์ (ปัจจุบัน YouTube ไม่ใช้นโยบายการใช้งานเริ่มต้นหากการอ้างสิทธิ์ที่แทรกไม่ได้ระบุนโยบาย แม้ว่าเอกสารประกอบจะระบุไว้ก่อนหน้านี้ว่ามีการดำเนินการดังกล่าว)

• เลิกใช้งานพร็อพเพอร์ตี้ hasUnpublishedDraft ของทรัพยากร policy แล้ว

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

• เราได้อัปเดตคำจำกัดความของพารามิเตอร์ releaseClaims สำหรับทั้งเมธอด references.patch และ references.update เพื่อระบุว่าพารามิเตอร์จะทำงานเมื่อมีการอัปเดตสถานะของการอ้างสิทธิ์เป็น inactive เท่านั้น ในกรณีนี้ คุณยังตั้งค่าพารามิเตอร์ releaseClaims เป็น true เพื่อปล่อยการอ้างสิทธิ์ที่ตรงกันทั้งหมดที่อ้างอิงสร้างขึ้นได้ด้วย

• เราได้อัปเดตทั้งเมธอด references.patch และ references.update เพื่อให้ทราบว่าคุณต้องระบุสถานะของการอ้างอิงเมื่อดำเนินการอย่างใดอย่างหนึ่ง

• เมธอด API หลายรายการรองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างระบุวิธีการและข้อผิดพลาดที่รองรับใหม่

  วิธีการ	ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  guideCategories.list	notFound	Unavailable	ไม่พบเนื้อหาที่คุณพยายามดึงนโยบายการจับคู่
  claims.get	notFound	Unavailable	ไม่พบการอ้างสิทธิ์ที่คุณพยายามดึงข้อมูล
  ownership.patch	invalidValue	Unavailable	ข้อมูลการเป็นเจ้าของที่คุณระบุมีค่าที่ไม่ถูกต้อง
  ownership.update	invalidValue	Unavailable	ข้อมูลการเป็นเจ้าของที่คุณระบุมีค่าที่ไม่ถูกต้อง