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

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

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

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

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

20 ธันวาคม 2022

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

9 พฤศจิกายน 2022

เราได้อัปเดตเอกสารประกอบสำหรับเมธอด asset.get และ asset.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

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

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

25 เมษายน 2022

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

8 ธันวาคม 2021

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

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

แต่ละ Use Case รองรับชุดพารามิเตอร์การค้นหาที่แตกต่างกัน เอกสารประกอบของเมธอด 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 รูปแบบของทรัพยากรเนื้อหา การนำเสนอเหล่านี้แสดงถึงรูปแบบข้อมูลการเผยแพร่ใหม่ที่ออกแบบมาเพื่อเพิ่มความโปร่งใสและทำให้คุณควบคุมวิธีเชื่อมโยงสิทธิ์ของตนเองกับเนื้อหาการบันทึกเสียงได้ดีขึ้น

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

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

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

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

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

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

11 สิงหาคม 2016

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

  • ข้อกำหนดในการให้บริการของบริการ YouTube API ที่เผยแพร่ใหม่ ("ข้อกำหนดที่อัปเดต") ซึ่งมีการอธิบายอย่างละเอียดในบล็อกวิศวกรและนักพัฒนาซอฟต์แวร์ของ 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 แสดงเฉพาะชิ้นงานที่สร้างขึ้นก่อนและ/หรือหลังวันที่ที่ระบุ

    • ตอนนี้พร็อพเพอร์ตี้ type รองรับค่า art_track_video ในการตอบกลับ API สําหรับคําขอ assetSearch.list แล้ว ศูนย์ช่วยเหลือของ 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 สําหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการของ YouTube API

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 จะแสดงข้อผิดพลาดนี้หากแก้ไข Flag 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 นี้เป็น 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 เพื่อระบุว่าอัปเดตค่าสำหรับการอ้างสิทธิ์การแลกเปลี่ยนเสียงไม่ได้

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