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

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

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

27 ตุลาคม 2026

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

  • รายการค่าที่ยอมรับได้สำหรับช่อง event[].reason ของทรัพยากร claimHistory ได้รับการอัปเดตแล้ว ดังนี้
    • ระบบได้เพิ่มค่าต่อไปนี้แล้ว appeal_expired, closed_manually_by_other_partner, licensed_off_platform, replaced และ synthetic_content_confirmed
    • ระบบจะไม่แสดงผลค่าต่อไปนี้อีกต่อไป: audio_muted, audio_replaced, audioswap_removed, channel_transferred, closed_audio_claim_on_visual_reference, closed_by_admin และ video_taken_down
  • พารามิเตอร์ inactiveReasons ของเมธอด claimSearch.list รองรับค่าใหม่ต่อไปนี้ appeal_expired, closed_manually_by_other_partner, closed_reference_conflict และ synthetic_content_confirmed

27 สิงหาคม 2026

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

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

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

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

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

4 สิงหาคม 2569

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

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

26 มีนาคม 2025

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป YouTube จะเปลี่ยนวิธีนับยอดดูสำหรับ Shorts ในอดีต ระบบจะนับยอดดู 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

ช่อง autoGeneratedBreaks[] ของทรัพยากร videoAdvertisingOption ได้รับการอัปเดตแล้ว เนื่องจากตอนนี้เราอนุญาตให้ระบุ ad_breaks และ autoGeneratedBreaks พร้อมกันได้ หากตั้งค่า autoGeneratedBreaks เป็น "จริง" ในวิดีโอที่มีการกำหนด 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 ต่อไปนี้

20 ธันวาคม 2022

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

9 พฤศจิกายน 2022

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

28 กันยายน 2022

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

18 กรกฎาคม 2022

เอกสารประกอบสำหรับ inactiveReasons ของเมธอด claimSearch.list ได้รับการอัปเดตเพื่อแสดงการปรับปร��งให้สอดคล้องกับ 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 APIs มาตรฐาน อัปเดตการเชื่อมโยงที่สร้างไว้ล่วงหน้าสำหรับ 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 ได้รับการอัปเดตเพื่อให้แสดงกรณีการใช้งาน 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 จะตรวจสอบและอัปโหลดแพ็กเกจที่มีเฉพาะข้อมูลเมตาซึ่งมีไฟล์ข้อมูลเมตาเพียงไฟล์เดียว
    • เมธอด 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 รูปแบบของทรัพยากรเนื้อหา การแสดงข้อมูลเหล่านี้จะแสดงให้เห็นรูปแบบข้อมูลการเผยแพร่ใหม่ที่ออกแบบมาเพื่อเพิ่มความโปร่งใสและทำให้คุณควบคุมวิธีเชื่อมโยงสิทธิ์ของตนเองกับเนื้อหาการบันทึกเสียงได้ดีขึ้น

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

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

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

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

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

  • พร็อพเพอร์ตี้ claimedVideoOptions.autoGeneratedBreaks ใหม่ของทรัพยากร contentOwnerAdvertisingOptions จะระบุว่า 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 ยังระบุออฟเซ็ตเวลาที่ส่วนที่ตรงกันแต่ละส่วนเริ่มต้นและสิ้นสุดทั้งในวิดีโอที่อ้างสิทธิ์และวิดีโออ้างอิงด้วย

    • ตอนนี้คุณสามารถอัปเดตค่าพร็อพเพอร์ตี้ claimedVideoOptions.newVideoDefaults[] ของทรัพยากร contentOwnerAdvertisingOptions ได้เมื่อเรียกใช้เมธอด 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[]

    • createdBefore แ���� createdAfter ใหม่ของเมธอด assetSearch.list จะสั่งให้ 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 เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการ API ของ YouTube

21 เมษายน 2015

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

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

    API รองรับเมธอดในการget list insert update patch และdeleteทรัพยากร campaign

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

30 มีนาคม 2015

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • พารามิเตอร์ isrcs ใหม่ของเมธอด assetSearch.list ช่วยให้คุณระบุรายการ 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 – วิดีโอที่คุณพยายามอ้างสิทธิ์ได้รับการยกเว้นจากนโยบายการลบออก หากมีข้อสงสัย โปรดติดต่อ copyright@youtube.com
    • 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 ใหม่ช่วยให้คุณค้นหาการอ้างสิทธิ์ที่ตรงตามเกณฑ์ต่อไปนี้อย่างน้อย 1 ข้อหรือทั้งหมดได้

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

      ทรัพยากร 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 เพื่อใช้นโยบายการลบวิดีโอกับการอ้างสิทธิ์ได้

    • พร็อพเพอร์ตี้ claimId ใหม่ของทรัพยากร reference จะปรากฏขึ้นหากมีการสร้างข้อมูลอ้างอิงโดยการเชื่อมโยงเนื้อหากับวิดีโอ 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 – คำขอระบุเกณฑ์ที่ไม่ถูกต้อง ต้องระบุพารามิเตอร์ตัวกรองต่อไปนี้เพียง 1 รายการ ได้แก่ 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

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

8 เมษายน 2013

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

  • เราได้เปลี่ยนชื่อ API เป็น YouTube Content ID API

  • พร็อพเพอร์ตี้หลายรายการมีการเปลี่ยนแปลงในทรัพยากร 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 แล้ว
    • ตอนนี้ค่าพร็อพเพอร์ตี้ 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 ข้อมูลการเป็นเจ้าของที่คุณระบุมีค่าที่ไม่ถูกต้อง