ประวัติการแก้ไข

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

หน้านี้จะแสดงการเปลี่ยนแปลง API และการอัปเดตเอกสารประกอบสําหรับทั้ง YouTube Reporting API และ YouTube Analytics API ทั้งสอง API ช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูล YouTube Analytics ได้หลากหลายวิธี สมัครรับข้อมูลบันทึกการเปลี่ยนแปลงนี้ ติดตาม

15 ธันวาคม 2022

API ของ YouTube Analytics (ข้อความค้นหาเป้าหมาย) รองรับมิติข้อมูลใหม่ 2 รายการ ได้แก่ รายงานใหม่ 1 รายการ ได้แก่

  • รายงานใหม่จะแสดงกิจกรรมของผู้ใช้ตามเมือง รายงานนี้ใช้ได้กับช่องและเจ้าของเนื้อหา รายงานนี้มีมิติข้อมูล city ใหม่ ซึ่งระบุค่าประมาณของ YouTube สําหรับเมืองที่เกิดกิจกรรมของผู้ใช้

  • มิติข้อมูล creatorContentType ใหม่จะระบุประเภทของเนื้อหา YouTube ที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูล ค่าที่รองรับคือ LIVE_STREAM, SHORTS, STORY และ VIDEO_ON_DEMAND

    ระบบรองรับมิติข้อมูล creatorContentType เป็นมิติข้อมูลที่ไม่บังคับสําหรับรายงานวิดีโอของช่องและเจ้าของเนื้อหาทั้งหมด

  • ตอนนี้คําแนะนําตัวอย่างคําขอใน YouTube Analytics API จะมีตัวอย่างสําหรับมิติข้อมูลใหม่ทั้ง 2 รายการ

  • นําการอ้างอิงไปยังมิติข้อมูล 7DayTotals และ 30DayTotals ออกจากเอกสารประกอบแล้ว เราได้เลิกใช้งานการเลิกใช้งานมิติข้อมูลเหล่านี้ในเดือนตุลาคม 2019

26 สิงหาคม 2022

API ของ YouTube Analytics (ข้อความค้นหาเป้าหมาย) และ API การรายงาน YouTube (รายงานจํานวนมาก) รองรับค่ารายละเอียดแหล่งที่มาของการเข้าชมใหม่ดังนี้

  • ใน YouTube Analytics API (Targeted query) API หากค่าของมิติข้อมูล insightTrafficSourceType คือ SUBSCRIBER คุณจะกําหนดค่า insightTrafficSourceDetail เป็น podcasts ได้ ซึ่งจะระบุว่าการเข้าชมนั้นมีการอ้างอิงจากหน้าปลายทางของพอดแคสต์
  • ใน API การรายงาน YouTube (รายงานจํานวนมาก) หากค่าของมิติข้อมูล traffic_source_type คือ 3 คุณจะกําหนดค่า traffic_source_detail เป็น podcasts ได้ ซึ่งระบุการเข้าชมจากการอ้างอิงจากหน้าปลายทางของพอดแคสต์

11 กุมภาพันธ์ 2022

ชุดค่าที่ถูกต้องสําหรับมิติข้อมูล gender จะมีการเปลี่ยนแปลงในวันที่ 11 สิงหาคม 2022 เป็นต้นไป เนื่องจากอาจมีการเปลี่ยนแปลงที่ใช้ร่วมกันไม่ได้กับการใช้งาน API ในส่วนของการเปลี่ยนแปลงที่เข้ากันไม่ได้กับข้อมูลย้อนหลังของข้อกําหนดในการให้บริการของบริการ API ของ YouTube เราจะประกาศการเปลี่ยนแปลงนี้ล่วงหน้า 6 เดือนก่อนที่การเปลี่ยนแปลงจะมีผล โปรดอัปเดตการใช้ API ก่อนวันที่ 11 สิงหาคม 2022 เพื่อให้การเปลี่ยนไปใช้ชุดค่าใหม่เป็นไปอย่างราบรื่น

การเปลี่ยนแปลงที่เกิดขึ้นมีดังนี้

  • ใน API ของ YouTube Analytics (การค้นหาเป้าหมาย) มิติข้อมูลgenderในปัจจุบันรองรับ 2 ค่า ได้แก่ female และ male ตั้งแต่วันที่ 11 สิงหาคม 2022 เป็นต้นไป มิติข้อมูลนั้นจะรองรับค่า 3 ค่า ได้แก่ female, male และ user_specified
  • ใน API การรายงาน YouTube (รายงานจํานวนมาก) ปัจจุบันมิติข้อมูล gender รองรับค่า 3 ค่า ได้แก่ FEMALE, MALE และ GENDER_OTHER ในวันที่ 11 สิงหาคม 2022 ชุดค่าที่รองรับจะเปลี่ยนเป็น FEMALE, MALE และ USER_SPECIFIED

9 กุมภาพันธ์ 2022

เราได้อัปเดตเมตริก 2 รายการเพื่อยกเว้นการเข้าชมการวนซ้ําคลิปตั้งแต่วันที่ 13 ธันวาคม 2021 การเปลี่ยนแปลงนี้ส่งผลต่อ API ของ YouTube Analytics (การค้นหาเป้าหมาย) และ API การรายงาน YouTube (รายงานจํานวนมาก)

2 กุมภาพันธ์ 2022

API การรายงาน YouTube (รายงานจํานวนมาก) นี้รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ที่ระบุว่ายอดดูมาจากการส่งผู้ชมแบบสด

  • ใน API การรายงาน YouTube (รายงานจํานวนมาก) มิติข้อมูล traffic_source_type รองรับค่า 28

สําหรับแหล่งที่มาของการเข้าชมประเภทนี้ มิติข้อมูล traffic_source_detail จะระบุรหัสแชแนลที่มีการอ้างอิงผู้ชม

23 กันยายน 2020

ทั้ง API ของ YouTube Analytics (การค้นหาเป้าหมาย) และ API การรายงาน YouTube (รายงานจํานวนมาก) รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ซึ่งบ่งชี้ว่าผู้ชมได้รับการแนะนําด้วยการปัดในแนวตั้งในแนวตั้งของการดู YouTube Shorts

  • ใน YouTube Analytics API (กําหนดเป้าหมายเป็น API) มิติข้อมูล insightTrafficSourceType จะรองรับค่า SHORTS
  • ใน API การรายงาน YouTube (รายงานจํานวนมาก) มิติข้อมูล traffic_source_type รองรับค่า 24

มิติข้อมูลรายละเอียดแหล่งที่มาของการเข้าชมซึ่งก็คือ insightTrafficSourceDetail ใน YouTube Analytics API หรือ traffic_source_detail ใน YouTube Reporting API ไม่ได้สร้างขึ้นสําหรับแหล่งที่มาของการเข้าชมใหม่นี้

20 กรกฎาคม 2020

การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง 2 ประการที่มีผลต่อ API ของ YouTube Analytics (ข้อความค้นหาเป้าหมาย)

  • ขนาดสูงสุดของกลุ่มการรายงานของ YouTube Analytics เพิ่มขึ้นจาก 200 เป็น 500 รายการ
  • พารามิเตอร์ filters ของวิธี reports.query ระบุรายการตัวกรองที่ควรใช้เมื่อดึงข้อมูล YouTube Analytics พารามิเตอร์นี้รองรับความสามารถในการระบุค่าหลายค่าสําหรับตัวกรอง video, playlist และ channel และจํานวนสูงสุดของรหัสที่ระบุสําหรับตัวกรองได้เพิ่มขึ้นจาก 200 เป็น 500 รายการ

13 กุมภาพันธ์ 2020

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาเป้าหมาย) และ API การรายงาน YouTube (รายงานจํานวนมาก) ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้ในศูนย์ช่วยเหลือของ YouTube

ใน API ทั้ง 2 ชุด ชุดรายละเอียดแหล่งที่มาของการเข้าชมที่เป็นไปได้สําหรับการแจ้งเตือนจะมีการเปลี่ยนแปลง ในคําค้นหาที่กําหนดเป้าหมาย ระบบจะรายงานการแจ้งเตือนเป็น insightTrafficSourceType=NOTIFICATION ในรายงานจํานวนมาก ระบบจะรายงานการแจ้งเตือนเป็น traffic_source_type=17

ค่าใหม่จะแบ่งการแจ้งเตือนที่เกี่ยวข้องกับวิดีโอและสตรีมแบบสดที่อัปโหลด ซึ่งก่อนหน้านี้รายงานเป็น uploaded เป็น 2 หมวดหมู่

  • uploaded_push - ยอดดูที่มาจากข้อความ Push ที่ส่งไปยังผู้ติดตามเมื่อมีการอัปโหลดวิดีโอ
  • uploaded_other - ยอดดูที่มาจากการแจ้งเตือนที่ไม่ใช่ข้อความ Push เช่น อีเมลหรือการแจ้งเตือนกล่องจดหมาย ที่ส่งถึงผู้ติดตามเมื่อมีการอัปโหลดวิดีโอ

ระบบจะแสดงค่าเหล่านี้สําหรับช่วงเวลาตั้งแต่ 13-01-2020 (13 มกราคม 2020)

นอกจากนี้ โปรดทราบว่าค่าเหล่านี้ไม่ได้แสดงถึงการแจ้งเตือนเอง แต่เป็นแหล่งที่มาของการเข้าชมที่ทําให้เกิดยอดดู YouTube บางรายการ เช่น หากแถวในรายงานระบุว่า views=3, traffic_source_type=17 (NOTIFICATION) และ traffic_source_detail=uploaded_push แถวดังกล่าวแสดงว่ายอดดู 3 ครั้งเกิดจากการที่ผู้ชมคลิกข้อความ Push ที่ส่งมาเมื่อมีการอัปโหลดวิดีโอ

15 ตุลาคม 2019

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ YouTube Analytics (กําหนดเป้าหมายไปยัง API)

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

    YouTube กําลังนําการรองรับมิติข้อมูล 7DayTotals และ 30DayTotals ออก คุณยังรวบรวมข้อมูลได้โดยใช้มิติข้อมูลเหล่านั้นจนถึงวันที่ 15 เมษายน 2020 ในวันที่หรือหลังจากนั้น การพยายามเรียกข้อมูลรายงานโดยใช้มิติข้อมูล 7DayTotals หรือ 30DayTotals จะแสดงผลข้อผิดพลาด

    โปรดทราบว่าผู้ใช้สามารถทําซ้ําข้อมูลบางส่วนสําหรับมิติข้อมูลเหล่านี้ได้โดยการค้นหาโดยใช้มิติข้อมูล day และรวบรวมหรือรับข้อมูลในช่วง 7 หรือ 30 วัน เช่น

    • จํานวนการดูในช่วงระยะเวลา 7 วันนั้นคํานวณได้โดยการรวมยอดดูจากแต่ละวันในช่วงเวลาดังกล่าว
    • ค่าเปอร์เซ็นต์ผู้ชมในระยะเวลา 7 วันคํานวณได้โดยการคูณยอดดูที่เกิดขึ้นในแต่ละวันด้วยเปอร์เซ็นต์ผู้ชมในวันนั้นเพื่อดูจํานวนผู้ชมที่ลงชื่อเข้าสู่ระบบเมื่อดูวิดีโอในวันนั้น จากนั้นจะเพิ่มจํานวนผู้ชมที่ลงชื่อเข้าสู่ระบบอยู่ตลอดระยะเวลาและหารด้วยจํานวนการดูทั้งหมดในช่วงเวลานั้นเพื่อดูเปอร์เซ็นต์ผู้ชมของทั้งช่วงเวลา
    • ระบบคํานวณจํานวนผู้ชมที่ไม่ซ้ํากันในระยะเวลา 7 วันไม่ได้ เนื่องจากผู้ชมรายเดียวกันจะคํานวณเป็นผู้ชมที่ไม่ซ้ํากันในวันที่ต่างกันได้ อย่างไรก็ตาม คุณอาจใช้มิติข้อมูล month แทนมิติข้อมูล 30DayTotals เพื่อประมาณข้อมูลเกี่ยวกับจํานวนผู้ชมที่ไม่ซ้ํากันในระยะเวลา 30 วันได้ โปรดทราบว่ามิติข้อมูล month หมายถึงเดือนในปฏิทิน ในขณะที่มิติข้อมูล 30DayTotals จะคํานวณระยะเวลา 30 วันตามวันที่เริ่มต้นและวันที่สิ้นสุดที่ระบุ

27 มิถุนายน 2019

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ YouTube Analytics (กําหนดเป้าหมายไปยัง API)

  • เนื่องจากเราได้เลิกใช้งาน API เวอร์ชัน 1 โดยสมบูรณ์แล้ว ระบบจึงอัปเดตเอกสารประกอบเพื่อนําการอ้างอิงออกจากเวอร์ชันดังกล่าว ซึ่งรวมถึงประกาศเกี่ยวกับการเลิกใช้งานและคําแนะนําในการย้ายข้อมูลที่จะอัปเดตเป็นเวอร์ชัน 2

1 พฤศจิกายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ YouTube Analytics (กําหนดเป้าหมายไปยัง API)

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

    โปรดทราบว่ากําหนดการของการเลิกใช้งานนี้คือประกาศครั้งแรกในวันที่ 26 เมษายน 2018

17 กันยายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ YouTube Analytics (กําหนดเป้าหมายไปยัง API)

  • ส่วนการลบข้อมูลระบุตัวบุคคลในเอกสารภาพรวมโมเดลข้อมูลใหม่อธิบายว่าข้อมูล YouTube Analytics บางรายการถูกจํากัดเมื่อเมตริกไม่เป็นไปตามเกณฑ์ที่กําหนด ปัญหานี้อาจเกิดขึ้นได้จากหลายกรณี ในทางปฏิบัติหมายความว่ารายงานอาจไม่มีข้อมูลของคุณทั้งหมด (หรือทั้งหมด) ในกรณีต่อไปนี้

    1. วิดีโอหรือช่องมีการเข้าชมที่จํากัดในระยะเวลาที่ระบุ

      หรือ

    2. คุณได้เลือกตัวกรองหรือมิติข้อมูล เช่น แหล่งที่มาของการเข้าชมหรือประเทศ ซึ่งค่าไม่เป็นไปตามเกณฑ์ที่กําหนด

    ส่วนใหม่ยังมีการพูดคุยเกี่ยวกับประเภทของข้อมูลที่อาจถูกจํากัดในรายงาน YouTube Analytics ด้วย

  • เอกสารรายงานช่องและรายงานเจ้าของเนื้อหาได้รับการอัปเดตให้สอดคล้องกับเมตริกของredViewsตําแหน่งการเล่น แหล่งที่มาของการเข้าชม และประเภทอุปกรณ์/ระบบปฏิบัติการแล้ว ซึ่งไม่รองรับเมตริก redViews และ estimatedRedMinutesWatched อีกต่อไป

18 มิถุนายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน YouTube Analytics (Targeted Query) API

  • มีการเปลี่ยนแปลงข้อกําหนดของขอบเขตสําหรับวิธีการต่อไปนี้
    • คําขอไปยังเมธอด reports.query ต้องมีสิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/youtube.readonly
    • คําขอสําหรับเมธอด groupItems.list ต้องมีสิทธิ์เข้าถึงอย่างใดอย่างหนึ่งต่อไปนี้
      • https://www.googleapis.com/auth/youtubeขอบเขต
        หรือ
      • ขอบเขต https://www.googleapis.com/auth/youtube.readonly
        และ
        ขอบเขต https://www.googleapis.com/auth/yt-analytics.readonly

      ตัวเลือกแรกจะใช้ขอบเขต 1 รายการและเป็นขอบเขตแบบอ่านเขียน ส่วนตัวเลือกที่ 2 จะใช้ขอบเขตแบบอ่านอย่างเดียว 2 ขอบเขต

23 พฤษภาคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน YouTube Analytics (Targeted Query) API

  • ภาพรวมของ API ประกอบด้วยส่วนใหม่รวบรวมเมตริกและรายการที่ถูกลบ ซึ่งอธิบายถึงวิธีที่การตอบกลับของ API จัดการข้อมูลที่เชื่อมโยงกับทรัพยากรที่ลบไปแล้ว เช่น วิดีโอ เพลย์ลิสต์ หรือช่อง
  • ส่วนแนวทางปฏิบัติแนะนําของภาพรวม API ได้รับการอัปเดตเพื่อช่วยเตือนว่าคุณสามารถใช้ YouTube Data API เพื่อดึงข้อมูลเมตาเพิ่มเติมสําหรับทรัพยากรที่ระบุในการตอบกลับ YouTube Analytics API ได้ ตามที่ระบุไว้ในนโยบายนักพัฒนาซอฟต์แวร์บริการ API ของ YouTube (ส่วนที่ 3.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API จะต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API ดังกล่าวหลังจากผ่านไป 30 วัน

22 พฤษภาคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API การรายงาน YouTube (รายงานจํานวนมาก)

  • ปัจจุบันการเปลี่ยนแปลงต่อไปนี้มีกําหนดเวลาที่จะมีผลในเดือนกรกฎาคม 2018 และนโยบายใหม่จะมีผลกับรายงานและงานการรายงานทั้งหมดทั่วโลก

    • หลังจากการเปลี่ยนแปลง รายงาน API ส่วนใหญ่รวมถึงรายงานโฆษณาทดแทนจะพร้อมให้บริการเป็นเวลา 60 วันนับจากวันที่สร้าง อย่างไรก็ตาม รายงานที่มีข้อมูลย้อนหลังจะใช้ได้เป็นเวลา 30 วันนับจากวันที่สร้าง

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

    • หลังการเปลี่ยนแปลง เมื่อคุณกําหนดเวลางานการรายงาน YouTube จะสร้างรายงานตั้งแต่วันนั้นเป็นต้นไปและครอบคลุมระยะเวลา 30 วันก่อนเวลานัดหมาย ก่อนการเปลี่ยนแปลง เมื่อคุณกําหนดเวลางานการรายงาน YouTube จะสร้างรายงานที่ครอบคลุมระยะเวลา 180 วันก่อนเวลาที่กําหนด

  • ส่วนแนวทางปฏิบัติแนะนําได้รับการอัปเดตเพื่อช่วยเตือนว่าคุณใช้ YouTube Data API เพื่อดึงข้อมูลเมตาเพิ่มเติมสําหรับทรัพยากรที่ระบุในรายงานได้ ตามที่ระบุไว้ในนโยบายนักพัฒนาซอฟต์แวร์บริการ API ของ YouTube (ส่วนที่ 3.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API จะต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API ดังกล่าวหลังจากผ่านไป 30 วัน

  • ส่วนลักษณะรายงานได้รับการอัปเดต โปรดทราบว่าแม้ระบบจะไม่กรองข้อมูลรายงานออก แต่รายงานที่มีข้อมูลสําหรับช่วงเวลาตั้งแต่ 1 มิถุนายน 2018 เป็นต้นไปจะไม่มีการอ้างอิงทรัพยากรของ YouTube ที่ถูกลบไปแล้วอย่างน้อย 30 วันก่อนสร้างรายงาน

  • เราได้อัปเดตส่วนข้อมูลย้อนหลังของภาพรวม API แล้ว โปรดทราบว่าเมื่อกําหนดเวลางานการรายงานใหม่ โดยปกติแล้วระบบจะโพสต์รายงานย้อนหลังภายใน 2-3 วัน ก่อนหน้านี้ เอกสารประกอบอาจใช้เวลาถึง 30 วันกว่าที่รายงานนี้จะมีผล

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

26 เมษายน 2018

API เวอร์ชัน 2 ของ YouTube Analytics (ข้อความค้นหาเป้าหมาย) (v2) พร้อมให้บริการต่อสาธารณะแล้ว รายการต่อไปนี้ระบุการเปลี่ยนแปลงของผลิตภัณฑ์และเอกสารที่เกี่ยวข้องกับ API เวอร์ชันใหม่

  • v2 API เกือบเหมือนกับ API v1 อย่างไรก็ตาม คุณอาจต้องอัปเดตโค้ดให้ตรงกับการเปลี่ยนแปลงที่แสดงด้านล่าง เราอธิบายการเปลี่ยนแปลงทั้งหมดนี้ไว้ในคําแนะนําในการย้ายข้อมูลใหม่

    • เวอร์ชันของ API เปลี่ยนจาก v1 เป็น v2
    • เปลี่ยน URL ฐานสําหรับคําขอ API จาก https://www.googleapis.com/youtube/analytics/v1 เป็น https://youtubeanalytics.googleapis.com/v2 แล้ว
    • พารามิเตอร์หลายรายการสําหรับเมธอด reports.query มีการอัปเดตชื่อ โดยเฉพาะอย่างยิ่ง ชื่อพารามิเตอร์ที่มีขีดกลาง เช่น end-date ในเคส v1 API ใช้อูฐ (endDate) แทนที่จะเป็นขีดกลางใน v2 API การเปลี่ยนแปลงนี้ทําให้ชื่อพารามิเตอร์สอดคล้องกันทั่วทั้ง API เนื่องจากเมธอดของ API สําหรับการสร้างและจัดการกลุ่มที่ใช้ตัวพิมพ์เล็กและอูฐสําหรับชื่อพารามิเตอร์อยู่แล้ว
    • API v2 ไม่รองรับคําขอแบบกลุ่มที่ส่งไปยังปลายทางกลุ่ม HTTP ทั่วโลกของ Google (www.googleapis.com/batch) หากส่งคําขอแบบกลุ่มใน API v2 คุณต้องใช้ปลายทาง https://youtubeanalytics.googleapis.com/v2 แทน

    นอกจากนี้ ระบบไม่รองรับฟีเจอร์ v1 บางรายการใน API v2 ดังนี้

    • เมธอด reports.query ไม่รองรับพารามิเตอร์คําขอ alt, quotaUser และ userIp อีกต่อไป
    • API เวอร์ชัน 2 ไม่มีปลายทางแบบกลุ่มที่รองรับกลุ่มที่ประกอบด้วยคําขอไปยัง API ต่างๆ (อย่างไรก็ตาม กลุ่มอาจประกอบด้วยคําขอที่ส่งไปยังเมธอดต่างๆ ของ API เดียวกัน) การเลิกใช้งานนี้ไม่ได้ใช้กับ API ของ YouTube Analytics เนื่องจาก Google จะเลิกใช้งานปลายทางกลุ่มทั่วโลกใน API ทั้งหมด
    • API v2 ไม่รองรับโปรโตคอล JSON-RPC ที่รองรับใน API v1 ขอย้ําอีกครั้งว่าการเลิกใช้งานนี้ไม่ได้ใช้กับ YouTube Analytics API เท่านั้น

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

    เราเลิกใช้งาน API เวอร์ชัน 1 (v1) แล้ว และจะรองรับจนถึงวันที่ 31 ตุลาคม 2018 คําขอทั้งหมดที่ส่งไปยัง v1 API จะหยุดทํางานหลังจากวันที่ดังกล่าว ดังนั้น โปรดอัปเกรดเป็น v2 API ภายในวันที่ 31 ตุลาคม 2018 เพื่อไม่ให้สิทธิ์การเข้าถึงข้อมูล YouTube Analytics ผ่าน API หยุดชะงัก

21 กุมภาพันธ์ 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน YouTube Analytics (Targeted Query) API

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

18 มกราคม 2018

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

  • API การรายงานของ YouTube (รายงานจํานวนมาก)

    • ตอนนี้มิติข้อมูล operating_system ซึ่งระบุระบบซอฟต์แวร์ของอุปกรณ์ที่มีการดูเกิดขึ้นแล้ว รองรับค่าต่อไปนี้แล้ว
      • 25: KaiOS

  • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

    • มิติข้อมูล operatingSystem รองรับค่ามิติข้อมูล KAIOS

20 ธันวาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลง 2 รายการที่เกี่ยวข้องกับ YouTube Reporting API ดังนี้

  • ขณะนี้เซิร์ฟเวอร์ API รองรับการบีบอัด gzip สําหรับคําขอที่ดาวน์โหลดรายงาน โปรดทราบว่าการบีบอัด API ของ gzip ไม่ได้รับการสนับสนุนสําหรับคําขอ API ประเภทอื่นๆ การเปิดใช้การบีบอัด gzip จะลดแบนด์วิดท์ที่จําเป็นสําหรับการตอบกลับ API แต่ละรายการ และแม้ว่าแอปพลิเคชันจะต้องการเวลา CPU มากขึ้นเพื่อยกเลิกการบีบอัดการตอบกลับของ API แต่ประโยชน์ของการใช้ทรัพยากรเครือข่ายน้อยลงมักมีน้ําหนักเกินต้นทุนนั้น

    หากต้องการได้รับการตอบกลับที่เข้ารหัสแบบ gzip ให้ตั้งค่าส่วนหัวของคําขอ HTTP Accept-Encoding เป็น gzip ดังที่แสดงในตัวอย่างต่อไปนี้

    Accept-Encoding: gzip

    ฟังก์ชันการทํางานนี้อธิบายไว้ในภาพรวม API และในคําจํากัดความของพร็อพเพอร์ตี้ downloadUrl ของทรัพยากร report

  • ระบบแก้ไขเอกสารประกอบของมิติข้อมูล age group และ gender เพื่อแสดงค่าจริงที่ API แสดงสําหรับมิติข้อมูลเหล่านั้น โปรดทราบว่านี่เป็นการแก้ไขเอกสาร และไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันหรือลักษณะการทํางานของ API โดยเฉพาะอย่างยิ่ง ค่าต่อไปนี้มีการเปลี่ยนแปลง

    • ค่าของมิติข้อมูล age_group ใช้ตัวอักษรพิมพ์ใหญ่ มีขีดล่างระหว่างคําว่า AGE กับตัวเลขในกลุ่มอายุ และใช้ขีดล่างแทนขีดกลาง ด้วยเหตุนี้ ระบบจึงแก้ไขค่า เช่น age13-17 และ age18-24 เป็น AGE_13_17 และ AGE_18_24 ตามลําดับ
    • ค่าของมิติข้อมูล gender ใช้ตัวอักษรพิมพ์ใหญ่ ดังนั้น ค่า female, male และ gender_other จึงได้รับการแก้ไขเป็น FEMALE, MALE และ GENDER_OTHER

10 สิงหาคม 2017

ในวันที่ 10 สิงหาคม 2016 เอกสารนี้ได้ประกาศการเลิกใช้งานเมตริก earnings API ของ YouTube Analytics (ในขณะเดียวกัน API ยังรองรับเมตริกใหม่ชื่อ estimatedRevenue ซึ่งให้ข้อมูลเดียวกันด้วย)

เนื่องจากเมตริก earnings เป็นเมตริกหลัก จึงมีการสนับสนุนเป็นเวลา 1 ปีนับจากวันที่ประกาศ ตอนนี้ระยะเวลา 1 ปีสิ้นสุดลงแล้ว แต่เมตริก earnings จะไม่ได้รับการสนับสนุนอีกต่อไป ดังนั้น คําขอ API ที่ระบุเมตริก earnings ตอนนี้จะแสดงโค้ดตอบกลับ HTTP ของ 400 หากคุณยังไม่ได้อัปเดตแอปให้ใช้เมตริก estimatedRevenue แทนเมตริก earnings โปรดดําเนินการโดยเร็วที่สุด

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

6 กรกฎาคม 2017

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

  • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

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

      ตัวอย่างเช่น หากคําขอระบุวันที่สิ้นสุดเป็นวันที่ 5 กรกฎาคม 2017 และค่าสําหรับเมตริกที่ขอทั้งหมดจะใช้งานได้จนถึงวันที่ 3 กรกฎาคม 2017 เท่านั้น ก็จะเป็นวันสุดท้ายที่ข้อมูลรวมอยู่ในการตอบกลับ (ข้อความนี้เป็นจริงแม้ว่าข้อมูลของเมตริกที่ขอบางรายการจะพร้อมใช้งานในวันที่ 4 กรกฎาคม 2017)

    • ตอนนี้มิติข้อมูล adType รองรับค่า reservedBumperInstream แล้ว ซึ่งหมายถึงโฆษณาวิดีโอแบบข้ามไม่ได้ที่เล่นสูงสุด 6 วินาทีก่อนที่จะดูวิดีโอได้ รูปแบบโฆษณานี้เหมือนกับโฆษณา auctionBumperInstream แต่ประเภทนี้หมายถึงโฆษณาที่ขายโดยการจอง ไม่ใช่แบบการประมูล

  • API การรายงานของ YouTube (รายงานจํานวนมาก)

    • ตอนนี้มิติข้อมูล ad_type รองรับค่า 20 แล้ว ซึ่งหมายถึงโฆษณาบัมเปอร์ที่ขายแบบจองแล้ว โฆษณาบัมเปอร์เป็นโฆษณาวิดีโอแบบข้ามไม่ได้ที่เล่นได้สูงสุด 6 วินาทีก่อนที่จะดูวิดีโอ โปรดทราบว่าค่า 19 สําหรับมิติข้อมูลนี้หมายถึงโฆษณาบัมเปอร์ที่ขายในการประมูลไม่ใช่แบบจองล่วงหน้า

    • ลบการรายงานสําหรับรายงาน YouTube Reporting API ต่อไปนี้แล้ว

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      เราประกาศประเภทรายงานเหล่านี้ว่าเลิกใช้งานแล้วในวันที่ 15 กันยายน 2016 และจะไม่มีการสร้างรายงานประเภทดังกล่าวหลังจากวันที่ 15 ธันวาคม 2016 รายงานที่สร้างขึ้นก่อนหน้านี้จะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง ด้วยเหตุนี้ รายงานบางส่วนจึงเข้าถึงได้ช้าในวันที่ 15 มิถุนายน 2017 แต่เนื่องจากรายงานไม่พร้อมใช้งานอีกต่อไป งานที่เชื่อมโยงกับรายงานจึงไม่จําเป็นเช่นกัน

24 พฤษภาคม 2017

งานการรายงานทั้งหมดสําหรับรายงาน YouTube Reporting API ต่อไปนี้ถูกลบออกแล้ว

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

เราประกาศประเภทรายงานเหล่านี้ว่าเลิกใช้งานแล้วในวันที่ 22 มิถุนายน 2016 และจะไม่มีการสร้างรายงานประเภทดังกล่าวหลังจากวันที่ 22 กันยายน 2016 รายงานที่สร้างขึ้นก่อนหน้านี้จะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง เราจึงเข้าถึงรายงานบางรายการได้ช้าที่สุดในวันที่ 22 มีนาคม 2017 แต่เนื่องจากรายงานไม่พร้อมใช้งานอีกต่อไป งานที่เชื่อมโยงกับรายงานจึงไม่จําเป็นเช่นกัน

22 พฤษภาคม 2017

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

  • API การรายงานของ YouTube (รายงานจํานวนมาก)

    • มิติข้อมูล sharing_service ซึ่งระบุบริการที่ใช้ในการแชร์วิดีโอ ตอนนี้รองรับค่าต่อไปนี้แล้ว

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      นอกจากนี้ ชื่อที่ใช้ระบุค่า 52 ได้รับการอัปเดตในเอกสารประกอบสําหรับ Kakao (Kakao Talk) เพื่อแยกความแตกต่างจากค่า 73 (Kakao Story) ให้ชัดเจนยิ่งขึ้น การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงใดๆ ของพฤติกรรม API หรือการแยกประเภทวิดีโอที่แชร์กับบริการเหล่านี้

  • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

    • มิติข้อมูล sharingService รองรับค่าต่อไปนี้แล้ว

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 มีนาคม 2017

ขณะนี้เจ้าของช่องที่เข้าถึงข้อมูลรายได้ผ่าน YouTube Analytics ใน Creator Studio สามารถเข้าถึงข้อมูลรายได้ดังกล่าวผ่าน YouTube Analytics API ได้เช่นกัน

17 มีนาคม 2017

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

  • YouTube Analytics API รองรับเมตริก redViews และ estimatedRedMinutesWatched ซึ่งทั้งคู่เกี่ยวข้องกับการดู YouTube Red อันที่จริง API รองรับเมตริกเหล่านี้มาสักระยะหนึ่งแล้ว และ YouTube Reporting API รองรับทั้ง 2 เมตริกที่ประกาศไว้ในวันที่ 15 กันยายน 2016 อยู่แล้ว

    • เมตริก redViews ระบุจํานวนครั้งที่สมาชิก YouTube Red ดูวิดีโอ
    • เมตริก estimatedRedMinutesWatched จะระบุจํานวนนาทีที่สมาชิก YouTube Red ดูวิดีโอ

    เราได้อัปเดตเอกสารรายงานช่องและรายงานเจ้าของเนื้อหาเพื่อแสดงรายงานที่รองรับเมตริกใหม่ 2 รายการ ระบบจะรองรับเมตริกเหล่านี้ในรายงานที่รองรับเมตริก views และ estimatedMinutesWatched อยู่แล้ว

3 มีนาคม 2017

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

  • API การรายงานของ YouTube (รายงานจํานวนมาก)

    • ระบบแก้ไขคําจํากัดความของมิติข้อมูล date แล้ว โปรดทราบว่าค่ามิติข้อมูลหมายถึงช่วงเวลาตั้งแต่ 00:00 น. เวลาแปซิฟิก และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีที่ระบุ เวลาเขตแปซิฟิกคือ UTC-7 หรือ UTC-8 ขึ้นอยู่กับช่วงเวลาของปี

      แม้ว่าปกติแล้ววันที่จะแสดงเวลา 24 ชั่วโมง แต่วันที่จะปรับนาฬิกาไปข้างหน้าจะเป็นเวลา 23 ชั่วโมง และวันที่ปรับนาฬิกาให้ย้อนหลังแสดงถึงระยะเวลา 25 ชั่วโมง (ก่อนหน้านี้ เอกสารระบุว่าแต่ละวันจะแสดงระยะเวลา 24 ชั่วโมงที่ไม่ซ้ํากัน และเขตเวลาแปซิฟิกใช้เวลา UTC-8 เสมอ)

      โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทํางานของ API จริง

    • ตอนนี้มิติข้อมูล operating_system ซึ่งใช้ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดยอดดูแล้ว จะรองรับค่าต่อไปนี้
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • ลบงานการรายงานทั้งหมดของประเภทรายงาน content_owner_basic_a1 แล้ว เราเลิกใช้งานรายงานประเภทดังกล่าวโดยสมบูรณ์แล้วในวันที่ 19 สิงหาคม 2016 แต่ก่อนหน้านี้รายงาน content_owner_basic_a1 ที่สร้างขึ้นยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง ด้วยเหตุนี้ รายงานบางส่วนจึงเข้าถึงได้ช้าในวันที่ 19 กุมภาพันธ์ 2017 แต่เนื่องจากรายงานไม่พร้อมใช้งานอีกต่อไป งานที่เชื่อมโยงกับรายงานจึงไม่จําเป็นเช่นกัน

  • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

    • รายละเอียดของมิติข้อมูลที่เกี่ยวข้องกับ time periods ได้รับการแก้ไขแล้วเนื่องจากค่าของมิติข้อมูลหมายถึงช่วงเวลาเริ่มต้นเวลา 00:00 น. เวลาแปซิฟิก และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน เดือน และปีที่ระบุ เวลาเขตแปซิฟิกคือ UTC-7 หรือ UTC-8 ขึ้นอยู่กับช่วงเวลาของปี

      แม้ว่าปกติแล้ววันที่จะแสดงเวลา 24 ชั่วโมง แต่วันที่จะปรับนาฬิกาไปข้างหน้าจะเป็นเวลา 23 ชั่วโมง และวันที่ปรับนาฬิกาให้ย้อนหลังแสดงถึงระยะเวลา 25 ชั่วโมง (ก่อนหน้านี้ เอกสารระบุว่าเวลาเขตแปซิฟิกคือ UTC-8 และไม่ได้กล่าวถึงความเป็นไปได้ที่วันที่ 1 วันจะไม่ใช่ระยะเวลา 24 ชั่วโมง)

      โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทํางานของ API จริง

    • เราได้ปรับปรุงเอกสารประกอบเกี่ยวกับรายงานช่อง โปรดทราบว่าขณะนี้รายงานช่องไม่มีเมตริกรายได้หรือประสิทธิภาพโฆษณา ด้วยเหตุนี้ ขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly จึงไม่ได้ให้สิทธิ์เข้าถึงข้อมูลด้านการเงินในรายงานแชแนลในขณะนี้

    • มิติข้อมูล operatingSystem รองรับค่ามิติข้อมูลใหม่ 3 ค่าดังนี้
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 กุมภาพันธ์ 2017

ปัจจุบัน YouTube Analytics API รองรับพารามิเตอร์ include-historical-channel-data ที่ไม่บังคับแล้ว โปรดทราบว่าพารามิเตอร์นี้เกี่ยวข้องเมื่อดึงข้อมูลรายงานเจ้าของเนื้อหาเท่านั้น

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

กฎเหล่านี้จะมีผลด้วยหากคําขอ API เรียกข้อมูลสําหรับหลายช่องทาง ดังนี้

  • หากค่าพารามิเตอร์คือ false เวลาในการรับชมและข้อมูลการดูที่แสดงในช่องหนึ่งๆ จะอิงตามวันที่ช่องนั้นลิงก์กับเจ้าของเนื้อหา

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

15 ธันวาคม 2016

ไม่รองรับรายงาน YouTube Reporting API ต่อไปนี้อีกต่อไปและถูกนําออกจากเอกสารแล้ว รายงานแต่ละรายการมีเวอร์ชันใหม่กว่า (ประกาศการเลิกใช้งานสําหรับรายงานเหล่านี้เกิดขึ้นเมื่อวันที่ 15 กันยายน 2016)

รายชื่อประเภทรายงานปัจจุบันในเอกสารอ้างอิง API ได้รับการอัปเดตด้วยเช่นกัน

11 พฤศจิกายน 2016

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

    YouTube Reporting API รองรับรายงาน End Screen ใหม่ 3 รายการ รวมถึงมิติข้อมูลและเมตริกใหม่ๆ สําหรับรายงานเหล่านั้น รายงานจะแสดงสถิติการแสดงผลและการคลิกผ่านสําหรับ End Screen ที่แสดงหลังจากที่วิดีโอหยุดเล่น

    • รายงาน End Screen

    • ขนาด End Screen

      • end_screen_element_type: ประเภทขององค์ประกอบ End Screen ที่เชื่อมโยงกับสถิติ
      • end_screen_element_id: รหัสที่ YouTube ใช้เพื่อระบุองค์ประกอบ End Screen แบบไม่ซ้ํา

    • เมตริก End Screen

      หมายเหตุ: ข้อมูลเมตริก End Screen พร้อมใช้งานแล้วตั้งแต่วันที่ 1 พฤษภาคม 2016

      • end_screen_element_impressions: จํานวนการแสดงผลองค์ประกอบ End Screen ทั้งหมด ระบบจะบันทึกการแสดงผล 1 ครั้งสําหรับองค์ประกอบ End Screen แต่ละรายการที่แสดง
      • end_screen_element_clicks: จํานวนครั้งที่มีการคลิกองค์ประกอบ End Screen
      • end_screen_element_click_rate: อัตราการคลิกผ่านสําหรับองค์ประกอบ End Screen

      • ศูนย์ช่วยเหลือของ YouTube มีข้อมูลโดยละเอียดเกี่ยวกับการเพิ่ม End Screen ในวิดีโอ

    • ระบบไม่รองรับรายงานต่อไปนี้อีกต่อไปและถูกนําออกจากเอกสารแล้ว รายงานแต่ละรายการมีเวอร์ชันใหม่กว่า (ประกาศการเลิกใช้งานสําหรับรายงานเหล่านี้เกิดขึ้นเมื่อวันที่ 22 มิถุนายน 2016)

    8 พฤศจิกายน 2016

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

    • เมตริกในรายการต่อไปนี้เลิกใช้งานแล้วและไม่มีการรองรับอีกต่อไป ตามที่ประกาศไปเมื่อวันที่ 10 สิงหาคม 2016 ระบบรองรับเมตริกใหม่ที่อ้างอิงข้อมูลเดียวกันแล้ว ตารางด้านล่างแสดงชื่อเมตริกที่เลิกใช้งานแล้วและชื่อเมตริกใหม่

      เมตริกที่เลิกใช้งานแล้ว เมตริกใหม่
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 ตุลาคม 2016

    ตอนนี้ YouTube สร้างชุดรายงานรายได้จากโฆษณาที่จัดการโดยระบบสําหรับเจ้าของเนื้อหาที่มีสิทธิ์เข้าถึงรายงานที่เกี่ยวข้องโดยอัตโนมัติในส่วนรายงานของ Creator Studio ของ YouTube รายงาน API ที่จัดการโดยระบบแบบใหม่ออกแบบมาเพื่อช่วยให้คุณเข้าถึงข้อมูลที่มีอยู่ในรายงาน Creator Studio ที่ดาวน์โหลดได้ด้วยตนเอง

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

    อัปเดตพร็อพเพอร์ตี้ id ของทรัพยากร reportType ให้รวมรายการรายงานที่จัดการโดยระบบที่คุณเข้าถึงผ่าน API ได้ ดังนี้

    • รายได้จากโฆษณารายเดือนทั่วโลกต่อวิดีโอ
    • รายได้จากโฆษณาต่อประเทศต่อวันต่อวิดีโอ
    • รายได้จากโฆษณารายเดือนทั่วโลกต่อชิ้นงาน
    • รายได้จากโฆษณารายวันต่อประเทศต่อเนื้อหา
    • การอ้างสิทธิ์ (รายงานนี้ไม่มีข้อมูลรายได้)

    27 กันยายน 2016

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

    เราเลิกใช้งานเมตริก uniques ของ YouTube Analytics API แล้ว เมตริกนี้ไม่ใช่เมตริกหลัก และจะมีการรองรับจนถึงวันที่ 31 ตุลาคม 2016

    15 กันยายน 2016

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

    • API รองรับเมตริกใหม่ 2 รายการที่เกี่ยวข้องกับผู้ชมใน YouTube Red ได้แก่

      • red_views: จํานวนครั้งที่สมาชิก YouTube Red ดูวิดีโอ
      • red_watch_time_minutes: จํานวนนาทีที่สมาชิก YouTube Red ดูวิดีโอ

    • API รองรับรายงาน 20 เวอร์ชันใหม่ เวอร์ชันใหม่ทั้งหมดรองรับเมตริก red_views และ red_watch_time_minutes ใหม่

      สําหรับแต่ละรายงาน หมายเลขในรหัสประเภทรายงานใหม่จะสูงกว่ารหัสประเภทรายงานเดิม 1 หมายเลข (ขณะนี้เลิกใช้งานรายงานเวอร์ชันเก่าตามที่อธิบายไว้ภายหลังในประวัติการแก้ไขนี้) ตัวอย่างเช่น ตอนนี้รายงาน channel_basic_a1 เลิกใช้งานแล้วและได้แทนที่ด้วยรายงาน channel_basic_a2 แล้ว

      รายการต่อไปนี้จะแสดงรหัสประเภทรายงานใหม่

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

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

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      หากมีงานในรายงานเหล่านั้น คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สําหรับงานเหล่านั้นหลังจากวันที่ 15 ธันวาคม 2016 รายงานที่สร้างขึ้นจะยังคงใช้ได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    19 สิงหาคม 2016

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

    • รายงาน content_owner_basic_a1 เลิกใช้งานแล้วและถูกนําออกจากเอกสารประกอบโดยสมบูรณ์ YouTube จะไม่สร้างรายงานใหม่ประเภทนี้อีกต่อไป แต่รายงานที่สร้างขึ้นแล้วจะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง

      การแทนที่รายงาน content_owner_basic_a1 คือรายงาน content_owner_basic_a2 ตามที่อธิบายไว้ในรายการประวัติการแก้ไขของวันที่ 19 พฤษภาคม 2016

    11 สิงหาคม 2016

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

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

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

    10 สิงหาคม 2016

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

    • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

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

        เมตริกในตารางต่อไปนี้เลิกใช้งานแล้ว ในขณะเดียวกัน ก็ได้เปิดตัวเมตริกใหม่ที่อ้างอิงข้อมูลเดียวกัน ซึ่งหมายความว่าระบบกําลังจะเปลี่ยนชื่อเมตริกเก่า แม้ว่า YouTube Analytics API จะรองรับชื่อเมตริกทั้ง 2 รายการจนกว่าจะถึงวันที่เลิกใช้งานในตาราง

        ชื่อเมตริกเดิม ชื่อเมตริกใหม่ วันที่ให้การสนับสนุน
        earnings estimatedRevenue 10 สิงหาคม 2017
        adEarnings estimatedAdRevenue 4 พฤศจิกายน 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4 พฤศจิกายน 2016
        impressionBasedCpm cpm 4 พฤศจิกายน 2016
        impressions adImpressions 4 พฤศจิกายน 2016

        โปรดทราบว่าเมตริก earnings เป็นเมตริกหลัก เราจึงรองรับเมตริกนี้เป็นเวลา 1 ปีนับจากวันที่ประกาศนี้ เมตริกอื่นๆ ที่ไม่ใช่เมตริกหลักจะได้รับการสนับสนุนเป็นเวลา 3 เดือนจนถึงวันที่ 4 พฤศจิกายน 2016

        ตัวอย่างเช่น คําขอ API จะระบุเมตริก impressionBasedCpm, เมตริก cpm หรือทั้งคู่ได้จนถึงวันที่ 4 พฤศจิกายน 2016 อย่างไรก็ตาม หลังจากวันที่ดังกล่าว ระบบจะรองรับเฉพาะเมตริก cpm

      • มิติข้อมูล insightTrafficSourceType รองรับค่ามิติข้อมูลใหม่ 2 ค่าดังนี้
        • CAMPAIGN_CARD: แหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานเจ้าของเนื้อหา เป็นข้อมูลที่ระบุว่ายอดดูมาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ ซึ่งเจ้าของเนื้อหาได้ใช้โปรโมตเนื้อหาที่ดู
        • END_SCREEN: ข้อมูลเกี่ยวข้องกับการดูที่มาจาก End Screen ของวิดีโออื่น

        คุณสามารถดึงรายงาน traffic source detail สําหรับแหล่งที่มาของการเข้าชมใหม่ทั้งสองได้ด้วย ในทั้ง 2 กรณี มิติข้อมูล insightTrafficSourceDetail จะระบุวิดีโอที่ผู้ชมใช้อ้างอิง

      • ตอนนี้มิติข้อมูล adType รองรับค่า auctionBumperInstream แล้ว ซึ่งหมายถึงโฆษณาวิดีโอแบบข้ามไม่ได้ที่เล่นสูงสุด 6 วินาทีก่อนที่จะดูวิดีโอได้

    • API การรายงานของ YouTube (รายงานจํานวนมาก)

      • ตอนนี้มิติข้อมูล traffic_source_type รองรับค่าต่อไปนี้แล้ว
        • 19: แหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานเจ้าของเนื้อหา เป็นข้อมูลที่ระบุว่ายอดดูมาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์ ซึ่งเจ้าของเนื้อหาได้ใช้โปรโมตเนื้อหาที่ดู
        • 20: ข้อมูลเกี่ยวข้องกับการดูที่มาจาก End Screen ของวิดีโออื่น

        สําหรับแหล่งที่มาของการเข้าชมใหม่ทั้ง 2 แห่ง มิติข้อมูล traffic_source_detail จะระบุวิดีโอที่มีการอ้างอิงถึงผู้ชม

      • รายการเมตริกหลักของ API ได้รับการแก้ไขแล้วเพื่อแสดง estimated_partner_revenue เป็นเมตริกหลัก และนํา earnings ออกจากรายการดังกล่าว (ระบบยังไม่รองรับเมตริก earnings ใน YouTube Reporting API)

      • ตอนนี้มิติข้อมูล ad_type รองรับค่า 19 ที่อ้างถึงโฆษณาบัมเปอร์ ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ที่เล่นสูงสุด 6 วินาทีก่อนที่จะดูวิดีโอ

    18 กรกฎาคม 2016

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

    • YouTube Analytics API (การค้นหาที่กําหนดเป้าหมาย)

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

      • รายการตัวกรองได้รับการแก้ไขสําหรับทั้งรายงานการคงผู้ชมไว้ของช่องและรายงานการคงผู้ชมไว้ของเจ้าของเนื้อหาเพื่อให้สอดคล้องกับตัวกรอง video และระบบไม่รองรับตัวกรอง group

        ก่อนหน้านี้ เอกสารสําหรับรายงานทั้ง 2 ฉบับระบุอย่างไม่ถูกต้องว่ารายงานสามารถดึงข้อมูลได้โดยใช้ตัวกรองใดตัวกรองหนึ่งหรือไม่ได้ใช้ตัวกรองทั้งสองรายการ

    • API การรายงานของ YouTube (รายงานจํานวนมาก)

      • ในภาพรวม API ส่วนที่อธิบายไว้ในวิธีเรียก URL การดาวน์โหลดของรายงานได้รับการแก้ไขเพื่อระบุว่า YouTube จะสร้างรายงานที่ดาวน์โหลดได้สําหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้มีแถวส่วนหัวแต่ไม่มีข้อมูลเพิ่มเติม ข้อมูลนี้ได้รับการอัปเดตแล้วในส่วนลักษณะของรายงานของเอกสารเดียวกันเมื่อวันที่ 12 เมษายน 2016
      • ระบบแก้ไขรายการมิติข้อมูลในรายงาน content_owner_asset_cards_a1 เพื่อแสดงให้เห็นว่ารายงานใช้มิติข้อมูล card_id ก่อนหน้านี้ เอกสารประกอบที่แสดงชื่อมิติข้อมูลเป็น card_title ไม่ถูกต้อง

    28 มิถุนายน 2016

    เราได้อัปเดตเอกสารประกอบเกี่ยวกับ YouTube Analytics API ให้สอดคล้องกับเมตริกการ์ดในรายงานช่องและเจ้าของเนื้อหาจํานวนมาก เมตริกใหม่ที่รองรับมีดังนี้

    เมตริกรองรับรายงานประเภทต่อไปนี้

    22 มิถุนายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง YouTube Reporting API ต่อไปนี้ การเปลี่ยนแปลงแรกเกี่ยวข้องกับ API โดยทั่วไป และการเปลี่ยนแปลงที่เหลือจะส่งผลต่อรายงานเจ้าของเนื้อหาเท่านั้น ดังนี้

    • ส่วนลักษณะรายงานของภาพรวม API ได้รับการอัปเดตเพื่อชี้แจงว่ารายงานพร้อมใช้งานผ่าน API เป็นเวลา 180 วันนับจากวันที่สร้าง

      ก่อนหน้านี้ เอกสารระบุว่ารายงานมีระยะเวลาไม่เกิน 180 วันก่อนวันที่ส่งคําขอ API และแม้ว่าในทางเทคนิคแล้ว ข้อความต้นฉบับก็จะไม่สร้างความสับสนใดๆ

    • API รองรับรายงาน 3 เวอร์ชันใหม่ รายงาน 2 รายการนี้มีเมตริกใหม่ที่ได้รับเปลี่ยนชื่อด้วย

      • รายงาน content_owner_ad_rates_a1 เป็นรายงาน content_owner_ad_performance_a1 เวอร์ชันใหม่ รายงานที่เปลี่ยนชื่อใหม่เหมือนกับเวอร์ชันก่อนหน้า

      • มีการเปลี่ยนชื่อรายงาน 2 รายการที่มีเวอร์ชันใหม่ ได้แก่

        • รายงาน content_owner_estimated_earnings_a1 เวอร์ชันใหม่ชื่อ content_owner_estimated_revenue_a1
        • รายงาน content_owner_asset_estimated_earnings_a1 เวอร์ชันใหม่ชื่อ content_owner_asset_estimated_revenue_a1

        รายงานที่เปลี่ยนชื่อใหม่ทั้ง 2 รายการจะแตกต่างจากรายงานเดิมในรูปแบบต่อไปนี้

        • ซึ่งจะเป็นการเพิ่มเมตริก estimated_partner_red_revenue ใหม่ ซึ่งจะประมาณรายได้ทั้งหมดจากการติดตาม YouTube Red
        • โดยจะเพิ่มเมตริก estimated_partner_transaction_revenue ใหม่ ซึ่งคาดคะเนรายได้จากธุรกรรม เช่น เนื้อหาแบบชําระเงินและการให้เงินสนับสนุนของแฟนๆ ลบด้วยการคืนเงินที่พาร์ทเนอร์เรียกเก็บ
        • โดยเปลี่ยนชื่อเมตริก estimated_partner_ad_sense_revenue เป็น estimated_partner_ad_auction_revenue
        • โดยเปลี่ยนชื่อเมตริก estimated_partner_double_click_revenue เป็น estimated_partner_ad_reserved_revenue

      โปรดทราบว่าหากมีงานที่ใช้สร้างรายงานเวอร์ชันเก่าเหล่านี้อยู่แล้ว คุณจะต้องสร้างงานใหม่สําหรับรายงานที่เปลี่ยนชื่อแล้ว เราจึงเลิกใช้งานรายงาน content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 และ content_owner_asset_estimated_earnings_a1 พร้อมกับการเปิดตัวรายงานเวอร์ชันใหม่

      หากมีงานในรายงานดังกล่าว คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สําหรับงานเหล่านั้นหลังจากวันที่ 22 กันยายน 2016 รายงานที่สร้างขึ้นจะยังคงใช้ได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    • อัปเดตคําจํากัดความของพร็อพเพอร์ตี้ id ของทรัพยากร reportType เพื่อแสดงถึงชุดรายงานที่มีอยู่ในปัจจุบัน

    • ชื่อของเมตริก 2 รายการได้รับการแก้ไขในเอกสารประกอบให้ตรงกับชื่อที่ปรากฏในรายงาน การดําเนินการนี้เป็นการแก้ไขเอกสารเท่านั้นและไม่ได้แสดงถึงการเปลี่ยนแปลงในเนื้อหารายงานจริง

      • ชื่อเมตริก estimated_partner_adsense_revenue ได้รับการอัปเดตเป็น estimated_partner_ad_sense_revenue แล้ว อย่างไรก็ตาม โปรดทราบว่าเมตริกนี้จะปรากฏในรายงาน 2 รายการที่เลิกใช้งานในการอัปเดตนี้เท่านั้น ตามที่อธิบายข้างต้น เมตริกนี้ได้เปลี่ยนชื่อเป็น estimated_partner_ad_auction_revenue ในรายงานเวอร์ชันใหม่แล้ว
      • ชื่อเมตริก estimated_partner_doubleclick_revenue ได้รับการอัปเดตเป็น estimated_partner_double_click_revenue แล้ว ขอย้ําอีกครั้งว่าเมตริกนี้จะปรากฏในรายงาน 2 ประเภทที่จะไม่ได้รับการอัปเดตเท่านั้น ตามที่อธิบายข้างต้น เมตริกนี้ได้เปลี่ยนชื่อเป็น estimated_partner_ad_reserved_revenue ในรายงานเวอร์ชันใหม่แล้ว

    • เอกสารประกอบของมิติข้อมูลสําหรับ Reporting API ได้รับการอัปเดตเพื่อไม่แสดงพร็อพเพอร์ตี้ elapsed_video_time_percentage และ audience_retention_type อีกต่อไป ปัจจุบันรายงานยังไม่รองรับผ่าน API

    19 พฤษภาคม 2016

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

    • API รองรับรายงานกิจกรรมของผู้ใช้สําหรับเจ้าของเนื้อหาเวอร์ชันใหม่ รหัสประเภทรายงานสําหรับรายงานใหม่คือ content_owner_basic_a2 เวอร์ชันใหม่รองรับเมตริก likes และ dislikes ซึ่งต่างจากรายงานเวอร์ชันก่อนหน้า content_owner_basic_a1

      หากมีงานที่สร้างรายงาน content_owner_basic_a1 อยู่แล้ว คุณก็ยังต้องสร้างงานใหม่สําหรับรายงาน content_owner_basic_a2 YouTube จะไม่ย้ายข้อมูลเจ้าของเนื้อหาไปยังรายงานเวอร์ชันใหม่โดยอัตโนมัติหรือสร้างงานโดยอัตโนมัติเพื่อสร้างรายงานเวอร์ชันใหม่ ในการใช้งานบางครั้ง ลักษณะที่ปรากฏของงานใหม่ที่ไม่คาดคิดอาจเป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

      ในการเปิดตัวรายงานใหม่ เราได้เลิกใช้งานรายงาน content_owner_basic_a1 แล้ว หากคุณมีงานให้กับรายงานดังกล่าว คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สําหรับงานนั้นหลังจากวันที่ 19 สิงหาคม 2016 รายงานที่สร้างขึ้นจะยังคงใช้ได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    • ทรัพยากร reportType, job และ report ทั้งหมดรองรับพร็อพเพอร์ตี้ใหม่ที่ระบุว่าทรัพยากรที่เกี่ยวข้องแสดงถึงประเภทรายงานที่เลิกใช้งานแล้วหรือไม่

      • พร็อพเพอร์ตี้ deprecateTime ของทรัพยากร reportType จะระบุวันที่และเวลาที่เลิกใช้งานประเภทรายงาน พร็อพเพอร์ตี้นี้มีเฉพาะค่าสําหรับรายงานที่ประกาศว่าเลิกใช้งานแล้ว และค่าจะแสดงวันที่ที่ YouTube จะหยุดสร้างรายงานประเภทนั้น

        หลังจากประกาศว่าประเภทรายงานเลิกใช้งานแล้ว YouTube จะสร้างรายงานประเภทนั้นอีก 3 เดือน ตัวอย่างเช่น การปรับปรุงนี้เมื่อวันที่ 19 พฤษภาคม 2016 เป็นการประกาศการเลิกใช้งานรายงาน content_owner_basic_a1 ดังนั้น deprecateTime สําหรับประเภทรายงานดังกล่าวจะระบุเวลาในวันที่ 19 สิงหาคม 2016 ซึ่งหลังจากนั้น YouTube จะหยุดสร้างรายงานประเภทดังกล่าว

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

      • พร็อพเพอร์ตี้ jobExpireTime ของทรัพยากร report ระบุวันที่และเวลาที่งานที่เชื่อมโยงกับรายงานหมดอายุหรือจะหมดอายุ พร็อพเพอร์ตี้นี้มีค่าเหมือนกับพร็อพเพอร์ตี้ expireTime ในทรัพยากร job ตามที่อธิบายไว้ในรายการก่อนหน้าในรายการนี้

    • ตอนนี้เมธอด jobs.create จะแสดงโค้ดตอบกลับ HTTP ของ 400 (Bad Request) หากคุณพยายามสร้างงานสําหรับรายงานที่เลิกใช้งานแล้ว นอกจากนี้ เอกสารประกอบของเมธอดนี้จะแสดงสาเหตุอื่นๆ อีกหลายประการที่ทําให้คําขอ API ล้มเหลว

    12 เมษายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ YouTube Reporting API เท่านั้น

    • ตอนนี้ YouTube สร้างข้อมูลที่ครอบคลุมระยะเวลา 180 วันก่อนที่จะมีการกําหนดเวลางานการรายงานเป็นครั้งแรก ก่อนหน้านี้ Reporting API ไม่ได้ให้ข้อมูลย้อนหลังใดๆ การเปลี่ยนแปลงนี้จะมีผลกับงานทั้งหมด รวมถึงงานที่สร้างขึ้นก่อนประกาศนี้ด้วย

      รายงานข้อมูลย้อนหลังจะได้รับการโพสต์ทันทีที่มีให้ใช้งาน แต่อาจใช้เวลาประมาณ 1 เดือนในการโพสต์ข้อมูลย้อนหลังทั้งหมดสําหรับงาน ดังนั้น 1 เดือนหลังจากกําหนดเวลางานการรายงาน คุณจะมีสิทธิ์เข้าถึงข้อมูลประมาณ 7 เดือน (ในการโพสต์ข้อมูลย้อนหลังทั้งหมดของงานที่สร้างก่อนการประกาศนี้ควรโพสต์ภายใน 1 เดือนของการประกาศ)

      โปรดทราบว่าข้อมูลย้อนหลังจะใช้ได้ตั้งแต่วันที่ 1 กรกฎาคม 2015 เท่านั้น ส่งผลให้งานที่สร้างก่อนวันที่ 28 ธันวาคม 2015 จะมีข้อมูลย้อนหลังไม่ถึง 180 วัน

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

    • เราได้อัปเดตส่วนลักษณะรายงานของภาพรวม API การรายงาน YouTube ด้วยการเปลี่ยนแปลงต่อไปนี้

      • ในตอนนี้เอกสารประกอบจะระบุว่ารายงานจะพร้อมใช้งานเป็นระยะเวลา 180 วันหลังจากที่สร้าง ดังนั้นไคลเอ็นต์ API จะดาวน์โหลดได้ ก่อนหน้านี้ เอกสารระบุว่ามีรายงานให้ใช้งานได้สูงสุด 6 เดือนก่อนการส่งคําขอ API

      • เอกสารประกอบได้รับการอัปเดตว่า API นี้สร้างรายงานที่ดาวน์โหลดได้สําหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้จะมีแถวส่วนหัวแต่จะไม่มีข้อมูลเพิ่มเติม

    • ในเร็วๆ นี้ YouTube Reporting API จะรองรับชุดรายงานที่ระบบจัดการโดยอัตโนมัติที่สร้างขึ้นซึ่งมีข้อมูลรายได้จากโฆษณาหรือข้อมูลรายได้จากการติดตาม YouTube Red เจ้าของเนื้อหาที่เข้าถึงรายงานรายได้ที่ดาวน์โหลดได้ด้วยตนเองใน Creator Studio ของ YouTube จะใช้รายงานนี้ได้ ดังนั้น ฟังก์ชัน API ใหม่ คุณจึงเข้าถึงข้อมูลดังกล่าวแบบเป็นโปรแกรมได้

      เรากําลังประกาศการเปลี่ยนแปลง API ต่อไปนี้เพื่อเตรียมเปิดตัวรายงานที่จัดการโดยระบบ

      • พร็อพเพอร์ตี้ systemManaged ใหม่ของทรัพยากร job บ่งบอกว่าทรัพยากรอธิบายงานที่สร้างรายงานที่จัดการโดยระบบหรือไม่ YouTube จะสร้างรายงานที่จัดการโดยระบบสําหรับเจ้าของเนื้อหา YouTube โดยอัตโนมัติ และเจ้าของเนื้อหาจะแก้ไขหรือลบงานที่สร้างรายงานเหล่านั้นไม่ได้

      • พารามิเตอร์ includeSystemManaged ใหม่ของเมธอด jobs.list ระบุว่าการตอบกลับ API ควรมีงานสําหรับรายงานที่จัดการโดยระบบหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือ false

      • พารามิเตอร์ startTimeAtOrAfter ใหม่ของเมธอด jobs.reports.list ระบุว่าการตอบกลับ API ควรมีรายงานเฉพาะในกรณีที่ข้อมูลแรกสุดในรายงานเป็นวันที่ที่ระบุหรือหลังจากนั้น ในทํานองเดียวกัน พารามิเตอร์ startTimeBefore ระบุว่าการตอบกลับ API ควรมีรายงานเฉพาะในกรณีที่ข้อมูลที่เร็วที่สุดในรายงานอยู่ก่อนวันที่ที่ระบุ

        พารามิเตอร์ใหม่นี้จะสัมพันธ์กับข้อมูลในรายงานในรายงาน ซึ่งแตกต่างจากพารามิเตอร์ createdAfter ของวิธีการนี้ ซึ่งเกี่ยวข้องกับเวลาที่สร้างรายงาน

      • พร็อพเพอร์ตี้ systemManaged ใหม่ของทรัพยากร reportType บ่งบอกว่าทรัพยากรอธิบายรายงานที่จัดการโดยระบบหรือไม่

      • พารามิเตอร์ includeSystemManaged ใหม่ของเมธอด reportTypes.list ระบุว่าการตอบกลับ API ควรมีรายงานที่จัดการโดยระบบหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือ false

    28 มีนาคม 2016

    ตอนนี้ YouTube Reporting API และ YouTube Analytics API แสดงสถิติการดูของบริการแชร์เพิ่มเติมหลายรายการแล้ว

    • ใน YouTube Reporting API มิติข้อมูล sharing_service รองรับค่าใหม่ต่อไปนี้
      • 82: กล่องโต้ตอบกิจกรรมของระบบ iOS
      • 83: กล่องจดหมาย Google
      • 84: Android Messenger
    • ใน YouTube Analytics API มิติข้อมูล sharingService รองรับค่าใหม่เหล่านี้
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: กล่องจดหมาย Google
      • IOS_SYSTEM_ACTIVITY_DIALOG: กล่องโต้ตอบกิจกรรมของระบบ iOS

    16 มีนาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งส่งผลต่อทั้ง YouTube Reporting API และ YouTube Analytics API

    API การรายงานของ YouTube

    • มิติข้อมูล playback_location_type รองรับค่ามิติข้อมูลใหม่ 2 ค่าดังนี้
      • 7: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นในหน้าแรกหรือหน้าจอหลักของ YouTube ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube
      • 8: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นโดยตรงในหน้าผลการค้นหาของ YouTube
    • ตอนนี้มิติข้อมูล traffic_source_type รองรับ 18 เป็นค่ามิติข้อมูลแล้ว ค่านี้จะระบุว่ายอดดูวิดีโอมาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากประเภทแหล่งที่มา 14 ซึ่งระบุว่าการดูเกิดขึ้นระหว่างที่วิดีโอกําลังเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์

    API ของ YouTube Analytics

    • มิติข้อมูล insightPlaybackLocationType รองรับค่ามิติข้อมูลใหม่ 2 ค่าดังนี้
      • BROWSE: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นในหน้าแรกหรือหน้าจอหลักของ YouTube ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube
      • SEARCH: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นโดยตรงในหน้าผลการค้นหาของ YouTube
    • ตอนนี้มิติข้อมูล insightTrafficSourceType รองรับ YT_PLAYLIST_PAGE เป็นค่ามิติข้อมูลแล้ว ค่านี้จะระบุว่ายอดดูวิดีโอมาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากประเภทแหล่งข้อมูล PLAYLIST ซึ่งบ่งบอกว่ายอดดูเกิดขึ้นระหว่างที่วิดีโอเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์

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

    ระบบได้อัปเดตรายการเมตริกที่รองรับสําหรับ YouTube Analytics API แล้ว เพื่อให้ไม่แสดงเมตริกการ์ดเป็นเมตริกที่รองรับสําหรับ API นั้นอีกต่อไป (รายงานของ API ดังกล่าวไม่มีการบันทึกไว้ว่ารองรับเมตริกการ์ดใดเลย)

    โปรดทราบว่าคุณยังคงดึงข้อมูลเมตริกการ์ดได้โดยใช้ YouTube Reporting API ซึ่งรองรับเมตริกเหล่านั้นสําหรับรายงานช่องและเจ้าของเนื้อหาจํานวนมาก

    6 มกราคม 2016

    ปัจจุบัน YouTube Reporting API และ YouTube Analytics API ระบุการดูที่เกิดขึ้นผ่านอุปกรณ์ Chromecast โดยเฉพาะ

    • ใน YouTube Reporting API มิติข้อมูล operating_system จะใช้ค่า 21 เพื่อระบุยอดดูที่เกิดขึ้นผ่าน Chromecast
    • ใน YouTube Analytics API มิติข้อมูล operatingSystem จะใช้ค่า CHROMECAST เพื่อระบุการดูที่เกิดขึ้นผ่าน Chromecast

    21 ธันวาคม 2015

    ในเอกสารประกอบ เราได้อัปเดตชื่อของเมตริก annotation_clickable_impressions และ annotation_closable_impressions ให้ตรงกับชื่อที่ส่งคืนในรายงาน ก่อนหน้านี้ ระบบจะบันทึกชื่อเป็น clickable_annotation_impressions และ closable_annotation_impressions

    18 ธันวาคม 2015

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

    15 ธันวาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ YouTube Analytics API

    • ตอนนี้ YouTube Analytics API รองรับมิติข้อมูลรายละเอียดการเล่นใหม่ 3 แบบแล้ว ซึ่งจะใช้ได้ในรายงานช่องและเจ้าของเนื้อหาที่หลากหลาย ดังนี้

      • liveOrOnDemand: มิติข้อมูลนี้บ่งบอกว่าข้อมูลในรายงานจะอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างการถ่ายทอดสดหรือไม่
      • subscribedStatus: มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของช่องหรือเพลย์ลิสต์หรือไม่
      • youtubeProduct: มิติข้อมูลนี้ระบุพร็อพเพอร์ตี้ของ YouTube ที่เกิดกิจกรรมของผู้ใช้ ค่าที่เป็นไปได้ ได้แก่ เว็บไซต์หลักของ YouTube (หรือแอป YouTube), YouTube Gaming และ YouTube Kids

      เราได้อัปเดตเอกสารประกอบเพื่อระบุรายงานรายละเอียดการเล่นใหม่ที่พร้อมใช้งานสําหรับช่องและเจ้าของเนื้อหา นอกจากนี้ รายงานอื่นๆ มากมายได้รับการอัปเดตให้ทราบว่ามิติข้อมูลเหล่านี้อย่างน้อย 1 รายการใช้เป็นมิติข้อมูลและ/หรือตัวกรองในรายงานเหล่านั้นได้

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

      เนื้อหา
      มิติข้อมูล:
      ต้องใช้ ประเภทอุปกรณ์
      ใช้ 0 ขึ้นไป วัน, liveOrOnDemand, subscribedStatus, youtubeProduct
      เมตริก:
      ใช้อย่างน้อย 1 รายการ ยอดดู, estimatedMinutesWatched
      ตัวกรอง:
      ใช้ 0 หรือ 1 ประเทศ, จังหวัด, ทวีป ทวีปย่อย
      ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม
      ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      คําศัพท์ที่อธิบายช่องที่จําเป็นและไม่บังคับอธิบายอยู่ในเอกสารประกอบสําหรับรายงานช่องและเจ้าของเนื้อหา

    • ขณะนี้ YouTube Analytics API จะทิ้งเอนทิตีที่ผู้ใช้ API ดึงข้อมูลจากตัวกรองที่รองรับหลายค่า (video, playlist และ channel) ได้โดยอัตโนมัติแล้ว ก่อนหน้านี้เซิร์ฟเวอร์ API จะแสดงผลข้อผิดพลาดหากผู้ใช้ API เข้าถึงข้อมูลสําหรับรายการที่ระบุอย่างน้อย 1 รายการไม่ได้

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

    • หากคุณขอข้อมูลสําหรับ YouTube Analytics group ที่ว่างเปล่า ตอนนี้ API จะแสดงชุดข้อมูลว่างแทนข้อผิดพลาด

    • ตอนนี้เมธอด groupItems.insert ของ YouTube Analytics API ส่งข้อผิดพลาดที่ไม่ได้รับอนุญาต (โค้ดตอบกลับ HTTP 403) หากคุณพยายามเพิ่มเอนทิตีลงในกลุ่ม แต่คุณไม่มีสิทธิ์เข้าถึงเอนทิตีนั้น ก่อนหน้านี้ API นี้จะอนุญาตให้คุณเพิ่มเอนทิตีลงในกลุ่ม แต่ภายหลังได้แสดงข้อผิดพลาดที่ไม่ได้รับอนุญาตเมื่อคุณพยายามเรียกข้อมูลรายงานสําหรับกลุ่มนั้น

    • เมธอด groups.list ของ YouTube Analytics API รองรับการใส่เลขหน้าแล้ว หากการตอบกลับ API ไม่มีกลุ่มที่ใช้ได้ทั้งหมด พารามิเตอร์ nextPageToken ของการตอบกลับจะระบุโทเค็นที่ใช้เพื่อดึงหน้าถัดไปของผลการค้นหาได้ ตั้งค่าพารามิเตอร์ pageToken ของเมธอดเป็นค่านั้นเพื่อดึงผลลัพธ์เพิ่มเติม

    10 พฤศจิกายน 2015

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

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

      ระบบได้อัปเดตรายการรายงานเจ้าของเนื้อหาของ YouTube Analytics API เพื่อระบุรายงานวิดีโอที่รองรับเมตริก redPartnerRevenue ดังนี้

    • ตอนนี้คําจํากัดความรายงานวิดีโอยอดนิยมสําหรับ YouTube Analytics API ยังแสดงให้เห็นว่ารายงานนี้รองรับเมตริกรายได้ earnings, adEarnings, grossRevenue, monetizedPlaybacks, playbackBasedCpm, impressions และ impressionBasedCpm ด้วย

    29 ตุลาคม 2015

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

    • เอกสารประกอบของมิติข้อมูล date ของ YouTube Reporting API ได้รับการแก้ไขเพื่อแสดงวันที่ที่อ้างอิงถึงระยะเวลา 24 ชั่วโมงตั้งแต่ 00:00 น. ตามเขตเวลาแปซิฟิก (UTC-8) ก่อนหน้านี้เอกสารระบุว่าวันที่เริ่มต้นเวลา 00:00 น. (GMT)

      นอกจากนี้ เอกสารประกอบเกี่ยวกับ YouTube Analytics API ยังได้รับการอัปเดตเพื่อแจ้งว่ามิติข้อมูลที่เกี่ยวข้องกับวันที่ทั้งหมด (day, 7DayTotals, 30DayTotals และ month) หมายถึงวันที่เริ่มเวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-8)

    • เมธอด jobs.reports.list() ของ YouTube Reporting API รองรับพารามิเตอร์การค้นหา createdAfter แล้ว หากระบุ พารามิเตอร์นี้จะระบุว่าการตอบกลับ API ควรแสดงเฉพาะรายงานที่สร้างหลังจากวันที่และเวลาที่ระบุ รวมถึงรายงานใหม่ที่มีข้อมูลที่ทดแทนด้วย โปรดทราบว่าค่าพารามิเตอร์จะเกี่ยวข้องกับเวลาที่สร้างรายงาน ไม่ใช่วันที่ที่เชื่อมโยงกับข้อมูลที่แสดงผล

      ค่าพารามิเตอร์คือการประทับเวลาในรูปแบบ RFC3339 UTC "ซูลู" ที่ถูกต้องเป็นไมโครวินาที ตัวอย่าง: "2015-10-02T15:01:23.045678Z"

      นอกจากนี้เรายังอัปเดตแนวทางปฏิบัติแนะนําสําหรับ YouTube Reporting API เพื่ออธิบายวิธีใช้พารามิเตอร์ createdAfter เพื่อหลีกเลี่ยงการประมวลผลรายงานเดียวกันซ้ําๆ

    • คําจํากัดความของพร็อพเพอร์ตี้ createTime ของทรัพยากร job และพร็อพเพอร์ตี้ startTime, endTime และ createTime ของทรัพยากร report ได้รับการแก้ไขแล้วเพื่อให้ค่าพร็อพเพอร์ตี้ถูกต้องเป็นไมโครวินาที ไม่ใช่นาโนวินาที นอกจากนี้ คําจํากัดความทั้งหมดจะแสดงอย่างถูกต้องว่าค่าพร็อพเพอร์ตี้เป็นการประทับเวลา

    8 ตุลาคม 2015

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

    • เอกสารประกอบสําหรับมิติข้อมูล sharingService ของ YouTube Analytics API ได้รับการอัปเดตให้รวมรายการค่ามิติข้อมูลที่เป็นไปได้ รายการนี้ประกอบด้วยบริการที่รองรับใหม่หลายรายการ

      นอกจากนี้ ยังได้อัปเดตคําจํากัดความของมิติข้อมูลสําหรับ sharing_service ของ YouTube Reporting API เพื่อแสดงรายการค่าที่รองรับใหม่ด้วย ค่า Enum ที่มากกว่า 59 เป็นค่าใหม่ในรายการ

    24 กันยายน 2015

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

    • API การรายงาน YouTube ใหม่จะเรียกรายงานข้อมูลจํานวนมากที่มีข้อมูล YouTube Analytics สําหรับช่องหรือเจ้าของเนื้อหา โดยออกแบบมาสําหรับแอปพลิเคชันที่สามารถนําเข้าชุดข้อมูลขนาดใหญ่และมีเครื่องมือสําหรับกรอง จัดเรียง และขุดข้อมูลดังกล่าว

      รายงาน Reporting API ของ YouTube แต่ละรายการจะมีชุดมิติข้อมูลและเมตริกที่กําหนดไว้ล่วงหน้า (รายงาน YouTube Analytics API ยังใช้เมตริกและมิติข้อมูลด้วย) ในรายงาน ข้อมูลแต่ละแถวจะมีชุดค่าผสมของค่ามิติข้อมูลที่ไม่ซ้ํากัน คุณรวมข้อมูลในแถวต่างๆ ตามค่ามิติข้อมูลเพื่อคํานวณเมตริกสําหรับวิดีโอ ประเทศ วิดีโอสด ผู้ใช้ที่ติดตาม และอื่นๆ ได้

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

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

      • แท็บคู่มือในชุดเอกสารประกอบมีข้อมูลทั่วไปสําหรับ API ทั้ง 2 ชุด ซึ่งรวมถึงวิธีให้สิทธิ์คําขอ API
      • แท็บรายงานจํานวนมากมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สําหรับ YouTube Reporting API โดยเฉพาะ
      • แท็บการค้นหาที่กําหนดเป้าหมายมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สําหรับ YouTube Analytics API โดยเฉพาะ
      • แท็บตัวอย่างจะแสดงตัวอย่างโค้ดที่มีสําหรับ API ทั้ง 2 รายการ
      • แท็บเครื่องมือจะแสดงแหล่งข้อมูลเพิ่มเติมที่มีไว้เพื่อช่วยให้นักพัฒนาซอฟต์แวร์ใช้ API ทั้ง 2 รายการได้

    20 สิงหาคม 2015

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

    • มีการปรับโครงสร้างเอกสารประกอบ API ขึ้นมาใหม่เพื่อให้ API เข้าใจได้ง่ายขึ้น ดังนั้น การเปลี่ยนแปลงเหล่านี้จึงไม่ได้อธิบายถึงฟีเจอร์ใหม่

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

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

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

    22 กรกฎาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงหลายรายการ ซึ่งทั้งหมดจะมีผลกับเจ้าของเนื้อหาเท่านั้น

    • เมตริก adEarnings ใหม่รวมรายได้โดยประมาณ (รายได้สุทธิ) จากแหล่งที่มาของโฆษณาที่ Google เป็นผู้ขายทั้งหมด ไม่ใช่เมตริกหลัก API รองรับเมตริก adEarnings สําหรับรายงานที่รองรับเมตริก earnings อยู่แล้ว

      นอกจากนี้ ยังได้แก้ไขคําจํากัดความของเมตริก earnings เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าค่านั้นรวมถึงรายได้โดยประมาณทั้งหมดจากแหล่งที่มาของโฆษณาที่ Google เป็นผู้ขายทั้งหมด รวมถึงจากแหล่งที่มาที่ไม่ใช่โฆษณา ก่อนหน้านี้ คําจํากัดความระบุอย่างไม่ถูกต้องว่าเมตริกรวมเฉพาะรายได้จากแหล่งที่มาของโฆษณา

    • เลิกใช้งานเมตริก primaryAdGrossRevenue แล้ว โปรดใช้เมตริก grossRevenue เพื่อดึงข้อมูลรายได้แทน

    • นอกเหนือจากเมตริก primaryAdGrossRevenue ที่เลิกใช้งานแล้ว รายงานประสิทธิภาพของโฆษณาไม่รองรับเมตริก monetizedPlaybacks และ playbackBasedCpm อีกต่อไป อย่างไรก็ตาม รายงานวิดีโอหลายรายการยังคงรองรับเมตริกเหล่านั้นอยู่

    1 มิถุนายน 2015

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

    • ตอนนี้ API รองรับเมตริกใหม่ 2 รายการสําหรับรายงานวิดีโอ videosAddedToPlaylists และ videosRemovedFromPlaylists แล้ว ระบบได้อัปเดตรายการรายงานวิดีโอสําหรับแชแนลและเจ้าของเนื้อหาเพื่อระบุรายงานที่รองรับเมตริกใหม่

      • videosAddedToPlaylists – จํานวนครั้งที่มีการเพิ่มวิดีโอในขอบเขตการค้นหาลงในเพลย์ลิสต์ YouTube โดยอาจเพิ่มวิดีโอลงในเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่น
      • videosRemovedFromPlaylists – จํานวนครั้งที่วิดีโอในขอบเขตการค้นหาถูกนําออกจากเพลย์ลิสต์ YouTube ระบบอาจนําวิดีโอออกจากเพลย์ลิสต์ของเจ้าของช่องหรือจากเพลย์ลิสต์ของช่องอื่น

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

      ข้อมูลสําหรับเมตริกเหล่านี้พร้อมใช้งานแล้วเมื่อวันที่ 1 ตุลาคม 2014

    31 มีนาคม 2015

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

    16 มีนาคม 2015

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

    • พารามิเตอร์ currency ใหม่ช่วยให้คุณเรียกข้อมูลเมตริกรายได้ในสกุลเงินอื่นที่ไม่ใช่ดอลลาร์สหรัฐ (USD) ได้หากมีการตั้งพารามิเตอร์ไว้ API จะแปลงค่าของเมตริก earnings, grossRevenue, playbackBasedCpm และ impressionBasedCpm เป็นสกุลเงินที่ระบุ ค่าที่แสดงผลเป็นค่าประมาณที่คํานวณโดยใช้อัตราแลกเปลี่ยนที่มีการเปลี่ยนแปลงทุกวัน

      ค่าพารามิเตอร์คือรหัสสกุลเงิน ISO 4217 ที่มี 3 ตัวอักษร ค่าเริ่มต้นคือ USD คําจํากัดความของพารามิเตอร์มีรายการรหัสสกุลเงินที่รองรับ

    25 กุมภาพันธ์ 2015

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

    • ในตอนนี้ API รองรับความสามารถในการสร้างและจัดการกลุ่ม YouTube Analytics รวมทั้งความสามารถในการดึงข้อมูลรายงานสําหรับกลุ่มเหล่านั้นแล้ว

      • การสร้างและจัดการกลุ่ม

        การอัปเดตนี้จะแนะนําทรัพยากรของ group และ groupItem สําหรับการสร้างและจัดการกลุ่ม

        • ทรัพยากร group แสดงถึงกลุ่ม Analytics ซึ่งเป็นคอลเล็กชันที่กําหนดเองของแชแนล วิดีโอ เพลย์ลิสต์ หรือชิ้นงานได้สูงสุด 200 รายการ API รองรับเมธอด list, insert, update และ delete สําหรับทรัพยากรนี้
        • ทรัพยากร groupItem แสดงถึงรายการในกลุ่ม Analytics API รองรับเมธอด list, insert และ delete สําหรับทรัพยากรนี้

        ตัวอย่างเช่น คุณอาจสร้างกลุ่มโดยใช้เมธอด groups.insert แล้วเพิ่มรายการลงในกลุ่มนั้นโดยใช้เมธอด groupItems.insert

      • การเรียกดูข้อมูลรายงานของกลุ่ม

        เอกสารประกอบของมิติข้อมูลได้รับการอัปเดตให้รวมมิติข้อมูล group ซึ่งใช้เป็นตัวกรองสําหรับรายงานช่องและรายงานเจ้าของเนื้อหาได้หลายรายการ เมื่อคุณใช้ตัวกรอง group API จะแสดงข้อมูลของรายการทั้งหมดในกลุ่มนั้น โปรดทราบว่าปัจจุบัน API ไม่รองรับการสร้างรายงานสําหรับกลุ่มชิ้นงาน

      ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่ม YouTube Analytics ได้ที่ศูนย์ช่วยเหลือของ YouTube

    13 กุมภาพันธ์ 2015

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

    • API ไม่รองรับมิติข้อมูล show แล้ว

    28 สิงหาคม 2014

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

    • ปัจจุบัน API รองรับความสามารถในการระบุค่าหลายค่าสําหรับมิติข้อมูล video, playlist, channel และ show เมื่อใช้มิติข้อมูลเหล่านั้นเป็นตัวกรอง หากต้องการระบุค่าหลายค่า ให้ตั้งค่าค่าพารามิเตอร์ filters เป็นรายการที่คั่นด้วยคอมมาของวิดีโอ, เพลย์ลิสต์, ช่อง หรือแสดงรหัสที่ควรกรองการตอบกลับ API ค่าพารามิเตอร์ระบุรหัสได้สูงสุด 200 รายการ

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

      ดูคําจํากัดความพารามิเตอร์ของ filters สําหรับรายละเอียดทั้งหมดเกี่ยวกับฟังก์ชันนี้

    16 กรกฎาคม 2014

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

    • เมื่อดึงข้อมูลรายงานแชแนล ตอนนี้คุณสามารถเรียกข้อมูลสําหรับช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วได้แล้วโดยตั้งค่าของพารามิเตอร์ ids เป็น channel==MINE (คุณยังสามารถตั้งพารามิเตอร์ ids เป็น channel==CHANNEL_ID เพื่อดึงข้อมูลสําหรับช่องที่ระบุได้)

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

      รายงานเพลย์ลิสต์ทั้งหมดรองรับเมตริก views และ estimatedMinutesWatched และรายงานบางอย่างยังรองรับเมตริก averageViewDuration ด้วย

      นอกจากนี้ รายงานเพลย์ลิสต์ทั้งหมดยังรองรับเมตริกใหม่ต่อไปนี้ด้วย โปรดทราบว่าเมตริกแต่ละรายการเหล่านี้แสดงถึงการดูเพลย์ลิสต์ที่เกิดขึ้นในเว็บเท่านั้น

      • playlistStarts: จํานวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์
      • viewsPerPlaylistStart: จํานวนยอดดูวิดีโอเฉลี่ยที่เกิดขึ้นทุกครั้งที่มีการเริ่มเล่นเพลย์ลิสต์
      • averageTimeInPlaylist: ระยะเวลาเฉลี่ยโดยประมาณในหน่วยนาทีที่ผู้ชมดูวิดีโอในเพลย์ลิสต์หลังจากเริ่มเพลย์ลิสต์

      คําขอเรียกรายงานเพลย์ลิสต์ต้องใช้ตัวกรอง isCurated ซึ่งต้องตั้งค่าเป็น 1 (isCurated==1)

    • API รองรับรายงานการคงผู้ชมไว้แล้ว รายงานนี้วัดความสามารถของวิดีโอในการคงผู้ชมไว้ มิติข้อมูล elapsedVideoTimeRatio ใหม่ของรายงานจะวัดจํานวนวิดีโอที่ผ่านไปแล้วสําหรับค่าเมตริกที่เกี่ยวข้อง

      • เมตริก audienceWatchRatio ระบุอัตราส่วนสัมบูรณ์ของผู้ดูที่รับชมวิดีโอในจุดที่ระบุของวิดีโอ อัตราส่วนนี้คํานวณโดยการเปรียบเทียบจํานวนครั้งที่มีการดูวิดีโอบางส่วนกับยอดดูทั้งหมดของวิดีโอ

        โปรดทราบว่าส่วนใดส่วนหนึ่งของวิดีโออาจมีการดูมากกว่า 1 ครั้ง (หรือไม่ดูเลย) ในการดูวิดีโอครั้งหนึ่งๆ ตัวอย่างเช่น หากผู้ใช้กรอกลับและดูวิดีโอช่วงเดียวกันหลายครั้งหลายครั้ง อัตราส่วนสัมบูรณ์สําหรับส่วนนั้นของวิดีโออาจมากกว่า 1

      • เมตริก relativeRetentionPerformance แสดงให้เห็นว่าวิดีโอคงผู้ชมไว้ระหว่างการเล่นได้ดีเพียงใดเมื่อเทียบกับวิดีโอ YouTube ทั้งหมดที่มีความยาวใกล้เคียงกัน ค่า 0 บ่งบอกว่าวิดีโอคงผู้ชมไว้แย่กว่าวิดีโออื่นๆ ที่มีความยาวใกล้เคียงกัน ขณะที่ค่า 0 บ่งบอกว่าวิดีโอคงผู้ชมไว้ได้ดีกว่าวิดีโออื่นที่มีความยาวเท่าๆ กัน ค่ามัธยฐานของ 0.5 บ่งบอกว่าวิดีโอขนาดใกล้เคียงกันครึ่งหนึ่งสามารถคงผู้ชมไว้ได้ดีขึ้น ขณะที่ครึ่งหนึ่งจะรักษาผู้ชมให้แย่ลง

      คุณยังสามารถใช้ตัวกรอง audienceType เพื่อให้รายงานแสดงเฉพาะข้อมูลที่เกี่ยวข้องกับการดูที่เกิดขึ้นเอง การดูจากโฆษณาแบบ TrueView ในสตรีม หรือการดูจากโฆษณา TrueView แบบบนหน้าจอ (การดูทั่วไปคือผลการค้นหาโดยตรงของผู้ใช้ เช่น การค้นหาวิดีโอ หรือการคลิกวิดีโอแนะนํา)

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

      • annotationImpressions: จํานวนการแสดงผลคําอธิบายประกอบทั้งหมด
      • annotationClickableImpressions: จํานวนคําอธิบายประกอบที่ปรากฏขึ้นและอาจคลิกได้
      • annotationClosableImpressions: จํานวนคําอธิบายประกอบที่ปรากฏและปิดได้
      • annotationClicks: จํานวนคําอธิบายประกอบที่คลิกทั้งหมด
      • annotationCloses: จํานวนคําอธิบายประกอบที่ปิดทั้งหมด

      เมตริกใหม่ทั้งหมดเป็นเมตริกหลัก และอยู่ภายใต้นโยบายการเลิกใช้งาน อย่างไรก็ตาม โปรดทราบว่าข้อมูลจะพร้อมใช้งานสําหรับเมตริกใหม่ในวันที่ 16 กรกฎาคม 2013 (ข้อมูลสําหรับเมตริก annotationClickThroughRate และ annotationCloseRate ใช้ได้ตั้งแต่วันที่ 10 มิถุนายน 2012)

    • ระบบจะไม่รายงาน GOOGLE_SEARCH เป็นค่าแยกต่างหากสําหรับมิติข้อมูล insightTrafficSourceType อีกต่อไป แต่การอ้างอิงจากผลการค้นหาของ Google จะระบุแหล่งที่มาประเภทการเข้าชม EXT_URL แทน ด้วยเหตุนี้ คุณจึงเรียกดูรายงานของ insightTrafficSourceDetail ที่ตั้งค่าตัวกรอง insightTrafficSourceType เป็น GOOGLE_SEARCH ไม่ได้อีกต่อไป

    31 มกราคม 2014

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

    • เอกสารรายงานเจ้าของเนื้อหาได้รับการอัปเดตเพื่อแสดงว่าเมตริก subscribersGained และ subscribersLost สามารถดึงข้อมูลสําหรับเนื้อหาที่มีการอ้างสิทธิ์หรืออัปโหลดโดยเจ้าของเนื้อหาได้แล้ว

      การเปลี่ยนแปลงนี้จะปรากฏในรายงานสถิติพื้นฐานแรกของเจ้าของเนื้อหา ซึ่งตอนนี้รองรับตัวกรอง claimedStatus และ uploaderType แล้ว

    16 มกราคม 2014

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

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

      • สถิติพื้นฐาน
      • ตามเวลา
      • ภูมิศาสตร์
      • ตำแหน่งที่เล่น
      • แหล่งที่มาของการเข้าชม
      • อุปกรณ์/ระบบปฏิบัติการ
      • ข้อมูลประชากร
      • โซเชียล
      • รายได้/โฆษณา (สําหรับรายงานเจ้าของเนื้อหาเท่านั้น)

    • ตอนนี้เอกสารตัวอย่างคําขอมีตัวอย่างใหม่เพื่อเรียกข้อมูลเฉพาะจังหวัดในรายงานช่องหรือรายงานเจ้าของเนื้อหา

      • เมตริกเฉพาะจังหวัดสําหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.: รายงานนี้ดึงข้อมูลรายละเอียดยอดดูในแต่ละจังหวัด และสถิติอื่นๆ ของวิดีโอของช่อง ข้อมูลนี้ครอบคลุมรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. ตัวอย่างนี้ใช้มิติข้อมูล province และใช้พารามิเตอร์ filters เพื่อจํากัดการตอบกลับให้แสดงเฉพาะผลลัพธ์สําหรับสหรัฐอเมริกาเท่านั้น

      • ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ): รายงานนี้จะดึงข้อมูลสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในรัฐแคลิฟอร์เนียที่ดูวิดีโอของช่อง หรือเนื้อหาที่มีการอ้างสิทธิ์ของเจ้าของเนื้อหาสําหรับรายงานเจ้าของเนื้อหา ตัวอย่างนี้ใช้พารามิเตอร์ filters เพื่อให้การตอบกลับมีเฉพาะข้อมูลของจังหวัดที่เฉพาะเจาะจงเท่านั้น

    • อัปเดตคําจํากัดความของมิติข้อมูล province แล้ว โปรดทราบว่าเมื่อรวม province ในค่าพารามิเตอร์ dimensions คําขอต้องจํากัดข้อมูลในสหรัฐอเมริกาด้วยการระบุ country==US ในค่าพารามิเตอร์ filters

    6 มกราคม 2014

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

    • เอกสารที่แสดงรายงานช่องและเจ้าของเนื้อหาที่รองรับได้รับการออกแบบใหม่ เอกสารแต่ละรายการจะจัดกลุ่มรายงานออกเป็นหมวดหมู่ต่างๆ แทนที่จะให้ตารางที่มีรายงานที่เป็นไปได้ทั้งหมด

      • สถิติพื้นฐาน
      • ตามเวลา
      • ภูมิศาสตร์
      • ตำแหน่งที่เล่น
      • แหล่งที่มาของการเข้าชม
      • อุปกรณ์/ระบบปฏิบัติการ
      • ข้อมูลประชากร
      • โซเชียล
      • วิดีโอยอดนิยม

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

    • ปัจจุบัน API รองรับมิติข้อมูลทางภูมิศาสตร์ใหม่ 3 รายการ ได้แก่ province, continent และ subContinent

      • มิติข้อมูล province ช่วยให้คุณเรียกดูสถิติสําหรับรัฐต่างๆ ในสหรัฐอเมริกาและเขตปกครองพิเศษโคลอมเบียได้ API รองรับการใช้งาน 2 รายการสําหรับมิติข้อมูลนี้

        • API รองรับรายงาน 2 รายการที่แจกแจงสถิติแบบทีละรัฐ รายงานทั้ง 2 ประเภทใช้ได้กับช่องและเจ้าของเนื้อหา

          • รายงานสถิติหลักจะแสดงสถิติหลายรายการ ซึ่งรวมถึงจํานวนการดูและนาทีที่ดูโดยประมาณ
          • รายงานตามเวลาจะให้สถิติเดียวกัน แต่รวมข้อมูลแบบรายวัน 7 วัน 30 วัน หรือรายเดือน

        • คุณสามารถใช้พารามิเตอร์การค้นหา filters เพื่อจํากัดรายงานให้มีเฉพาะสถิติสําหรับแต่ละรัฐเท่านั้น รายงานจํานวนมากรองรับการกรองประเภทนี้ ซึ่งรวมถึงรายงานทางภูมิศาสตร์ รายงานตําแหน่งที่เล่น รายงานแหล่งที่มาของการเข้าชม รายงานอุปกรณ์ รายงานระบบปฏิบัติการ รายงานข้อมูลประชากร และรายงานวิดีโอยอดนิยม

      • มิติข้อมูล continent ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ที่ระบุทวีป มิติข้อมูลนี้ใช้เป็นตัวกรองได้เท่านั้น

      • มิติข้อมูล subContinent ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ซึ่งระบุภูมิภาคย่อยของทวีป มิติข้อมูลนี้ใช้เป็นตัวกรองเท่านั้น

        เนื่องจากภูมิภาคย่อยแต่ละแห่งเชื่อมโยงกับทวีปเดียวเท่านั้น จึงไม่จําเป็นต้องใช้ตัวกรอง continent เมื่อคุณใช้ตัวกรอง subContinent (อันที่จริง API จะแสดงข้อผิดพลาดหากคําขอใช้ทั้ง 2 มิติข้อมูล)

    • เอกสารประกอบได้รับการแก้ไขแล้วเพื่อให้มิติข้อมูล insightTrafficSourceDetail ไม่มีค่า insightTrafficSourceType PROMOTED เป็นค่าตัวกรองที่ถูกต้อง

    30 กันยายน 2013

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

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

    • ตอนนี้ API รองรับค่า EXTERNAL_APP สําหรับมิติข้อมูล insightPlaybackLocationType แล้ว ควบคู่กับการอัปเดตเมื่อวันที่ 10 กันยายน 2013 การเล่นจะไม่ได้รับการจัดหมวดหมู่เป็นการเล่น MOBILE อีกต่อไป แม้ว่าการเล่นบนอุปกรณ์เคลื่อนที่ที่เกิดขึ้นก่อนวันที่ดังกล่าวจะยังคงได้รับการจัดหมวดหมู่เป็นค่านั้น

      จากการอัปเดตนี้ การเล่นบนอุปกรณ์เคลื่อนที่จัดเป็นการเล่น WATCH, EMBEDDED หรือ EXTERNAL_APP ขึ้นอยู่กับประเภทของแอปพลิเคชันที่เล่น

    • ตอนนี้ API รองรับค่า PLAYLIST สําหรับมิติข้อมูล insightTrafficSourceType แล้ว ค่านี้ระบุว่ายอดดูวิดีโอมาจากเพลย์ลิสต์ ก่อนหน้านี้การแสดงผลเหล่านี้จะได้รับการจัดประเภทโดยใช้หมวดหมู่ YT_OTHER_PAGE ของมิติข้อมูล

    16 กรกฎาคม 2013

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

    • ปัจจุบัน API รองรับความสามารถในการจัดเรียงรายงานตามมิติข้อมูลและเมตริกหลายรายการ เอกสารคําขอตัวอย่างมีตัวอย่างใหม่ซึ่งก็คือการจัดเรียงคําขอตามมิติข้อมูล/เมตริกหลายรายการ ซึ่งสาธิตฟังก์ชันการทํางานนี้ คําขอจะดึงข้อมูลแหล่งที่มาของการเข้าชมและมีค่าพารามิเตอร์ sort เป็น day,-views ผลการค้นหาจะจัดเรียงตามลําดับเวลา แต่ภายในชุดผลลัพธ์สําหรับแต่ละวัน แถวแรกจะมีข้อมูลสําหรับแหล่งที่มาของการเข้าชมที่มียอดดูมากที่สุด ส่วนแถวที่ 2 จะมีข้อมูลสําหรับแหล่งที่มาที่มียอดดูสูงสุดเป็นอันดับถัดไป

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

      • รายงานdeviceTypeช่วยให้คุณเรียกข้อมูลยอดดูและเวลาในการรับชมโดยประมาณสําหรับอุปกรณ์ประเภทต่างๆ เช่น เดสก์ท็อป อุปกรณ์เคลื่อนที่ และแท็บเล็ตได้ คุณยังสามารถใช้ตัวกรอง operatingSystem เพื่อจํากัดรายงานประเภทอุปกรณ์ให้แสดงเฉพาะสถิติสําหรับอุปกรณ์ที่ใช้ระบบปฏิบัติการที่เฉพาะเจาะจง เช่น Android หรือ iOS

      • รายงานoperatingSystemช่วยให้คุณเรียกดูยอดดูและเวลาในการรับชมโดยประมาณสําหรับระบบปฏิบัติการต่างๆ ได้ เช่น Android, iOS, Linux และอื่นๆ คุณยังสามารถใช้ตัวกรอง deviceType เพื่อจํากัดรายงานระบบปฏิบัติการให้แสดงเฉพาะสถิติสําหรับอุปกรณ์บางประเภทเท่านั้น เช่น อุปกรณ์เคลื่อนที่หรือแท็บเล็ต

      รายงานประเภทอุปกรณ์และระบบปฏิบัติการใหม่จะพร้อมใช้งานสําหรับช่องและเจ้าของเนื้อหา

    • อัปเดตเอกสารตัวอย่างคําขอให้รวมรายงานอุปกรณ์ 3 ฉบับสําหรับช่องต่างๆ และรายงานอุปกรณ์ 3 ฉบับสําหรับเจ้าของเนื้อหา

    • มิติข้อมูล insightPlaybackLocationType อาจแสดงผลค่า YT_OTHER ซึ่งระบุการดูที่ไม่ได้รับการจัดประเภทโดยใช้ค่าอื่นๆ ของมิติข้อมูล

    23 พฤษภาคม 2013

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

    10 พฤษภาคม 2013

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

    6 พฤษภาคม 2013

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

    • ตอนนี้ API รองรับความสามารถในการเรียกดูเมตริกเวลาในการรับชม estimatedMinutesWatched, averageViewDuration และ averageViewPercentage ร่วมกับเมตริกอื่นๆ รวมถึงเมตริกการดู เมตริกการมีส่วนร่วม เมตริกรายได้ และเมตริกประสิทธิภาพของโฆษณา

      ระบบได้อัปเดตรายการรายงานช่องและรายงานเจ้าของเนื้อหาที่พร้อมใช้งานเพื่อแสดงถึงการเปลี่ยนแปลงนี้ (ขณะนี้รายการจะสั้นลงเนื่องจากระบบเรียกข้อมูลเมตริกเวลาในการรับชมเป็นส่วนหนึ่งของรายงานอื่นๆ ที่อยู่ในรายการได้)

      เอกสาร ตัวอย่าง API คําขอ ได้รับการอัปเดตแล้ว

    • รายงานที่ใช้มิติข้อมูล insightPlaybackLocationDetail และ insightTrafficSourceDetail ได้รับการปรับปรุงด้วยวิธีต่อไปนี้

      • ตอนนี้รองรับตัวกรอง country ที่ไม่บังคับแล้ว

      • ตอนนี้เจ้าของเนื้อหาสามารถเรียกดูรายงานเหล่านี้ได้โดยใช้ชุดค่าผสม filter ใหม่ต่อไปนี้ โปรดทราบว่าชุดค่าผสมเหล่านี้ทั้งหมดยังรองรับตัวกรอง country ที่ไม่บังคับด้วย

        • รายละเอียดของตําแหน่งการเล่น

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • รายละเอียดแหล่งที่มาของการเข้าชม

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    3 พฤษภาคม 2013

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

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

    • ตอนนี้มิติข้อมูล insightTrafficSourceType รองรับ SUBSCRIBER เป็นค่าที่ถูกต้องแล้ว ค่านี้จะระบุยอดดูของวิดีโอที่อ้างอิงจากฟีดในหน้าแรกของ YouTube หรือจากฟีเจอร์การติดตามของ YouTube หากกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุฟีดหน้าแรกหรือหน้าอื่นๆ ที่มีการอ้างอิงการดู

    28 มีนาคม 2013

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

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

      • annotationClickThroughRate – อัตราส่วนของคําอธิบายประกอบที่ผู้ชมคลิกต่อจํานวนการแสดงผลคําอธิบายประกอบที่คลิกได้ทั้งหมด
      • annotationCloseRate – อัตราส่วนของคําอธิบายประกอบที่ผู้ชมปิดต่อจํานวนการแสดงผลคําอธิบายประกอบทั้งหมด

    21 มีนาคม 2013

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

    • ตอนนี้ API รองรับเมตริกรายได้และประสิทธิภาพของโฆษณา รวมถึงรายงานประสิทธิภาพโฆษณาใหม่แล้ว เมตริกและรายงานทั้งหมดจะเข้าถึงได้เฉพาะพาร์ทเนอร์เนื้อหาของ YouTube ที่เข้าร่วมในโปรแกรมพาร์ทเนอร์ YouTube เท่านั้น

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

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

        • earnings – รายได้โดยประมาณทั้งหมดจากแหล่งที่มาทั้งหมดที่ Google เป็นผู้ขาย
        • grossRevenue – รายได้รวมโดยประมาณจากพาร์ทเนอร์ของ Google หรือ DoubleClick
        • primaryAdGrossRevenue – รายได้รวมโดยประมาณ ผลรวม และจัดประเภทตามประเภทโฆษณาหลักสําหรับการเล่นวิดีโอที่รายงานครอบคลุม จากพาร์ทเนอร์ Google หรือ DoubleClick
        • monetizedPlaybacks – จํานวนการเล่นที่แสดงการแสดงโฆษณาอย่างน้อย 1 ครั้ง
        • playbackBasedCpm – รายได้รวมโดยประมาณต่อการเล่น 1,000 ครั้ง
        • impressions – จํานวนการแสดงโฆษณาที่ได้รับการยืนยันที่แสดง
        • impressionBasedCpm – รายได้รวมโดยประมาณต่อการแสดงโฆษณา 1,000 ครั้ง

        หมายเหตุ: ดูรายละเอียดทั้งหมดในคําจํากัดความของเมตริก

      • คําขอที่ดึงข้อมูลรายได้หรือเมตริกประสิทธิภาพของโฆษณาต้องส่งโทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงโดยใช้ขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly ใหม่

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

    4 กุมภาพันธ์ 2013

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

    • ตอนนี้คู่มืออ้างอิงของ API มีส่วนตัวอย่าง ซึ่งจะรวมถึงตัวอย่างโค้ดที่สาธิตวิธีเรียก API โดยใช้ไลบรารีของไคลเอ็นต์ Java, JavaScript, Python และ Ruby ตัวอย่างโค้ด JavaScript คือตัวอย่างที่พูดถึงรายละเอียดในเอกสารประกอบแอปพลิเคชันตัวอย่าง

    14 พฤศจิกายน 2012

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

    • ตอนนี้คู่มืออ้างอิง API มี APIs Explorer ซึ่งจะช่วยให้คุณเรียกใช้ API ดูคําขอ API และเรียกดูข้อมูลจริงในการตอบกลับได้

    • API รองรับรายงานใหม่มากมายสําหรับทั้งช่องและเจ้าของเนื้อหาตามที่อธิบายไว้ด้านล่าง รายงานแต่ละฉบับแสดงเป็นรายงานช่องหรือรายงานเจ้าของเนื้อหา หน้ามิติข้อมูลและเมตริกได้รับการอัปเดตตามเช่นกัน

      • รายงานตําแหน่งที่เล่นจะระบุจํานวนการดูวิดีโอที่เกิดขึ้นในหน้าเว็บหรือแอปพลิเคชันประเภทต่างๆ

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

      • รายงานแหล่งที่มาของการเข้าชมจะระบุยอดดูวิดีโอที่มาจากผู้อ้างอิงประเภทต่างๆ

      • รายงานรายละเอียดแหล่งที่มาของการเข้าชมจะระบุ URL ที่มาซึ่งสร้างยอดดูมากที่สุดสําหรับวิดีโอที่ระบุและประเภทแหล่งที่มาของการเข้าชมที่ระบุ ตัวอย่างเช่น รายงานนี้อาจให้วิดีโอที่เกี่ยวข้องซึ่งส่งการเข้าชมมากที่สุดไปยังวิดีโอที่เฉพาะเจาะจง รายงานนี้ใช้ได้กับแหล่งที่มาของการเข้าชมหลายแห่ง

      • รายงานเวลาในการรับชมแสดงระยะเวลาที่ผู้ชมใช้ดูเนื้อหา รายงานสามารถรวมข้อมูลสําหรับกรอบเวลาเฉพาะเจาะจง เช่น วัน 7 วันที่ผ่านมา 30 วันที่ผ่านมา หรือประเทศ หากรายงานรวบรวมข้อมูลตามวันหรือประเทศ ก็จะระบุความยาวเฉลี่ยของการดูวิดีโอแต่ละครั้งและเปอร์เซ็นต์โดยเฉลี่ยของวิดีโอแต่ละรายการที่ผู้ใช้ดูได้ด้วย

    2 ตุลาคม 2012

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

    • YouTube Analytics API พร้อมให้นักพัฒนาแอปทุกคนใช้งานแล้ว คุณสามารถเปิดใช้งาน API สําหรับโปรเจ็กต์ของคุณได้โดยไม่ต้องขอสิทธิ์เข้าถึงจากแผงบริการใน APIs console ก่อน

    • ส่วนการเริ่มต้นใช้งานใหม่จะระบุข้อกําหนดเบื้องต้นและขั้นตอนพื้นฐานในการสร้างแอปพลิเคชันที่ใช้ YouTube Analytics API

    12 กันยายน 2012

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

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

    • ส่วนมิติข้อมูลชั่วคราวได้รับการอัปเดตเพื่ออธิบายว่ามิติข้อมูลเหล่านั้นระบุว่ารายงาน Analytics ควรรวมข้อมูลตามช่วงเวลา ปัจจุบัน API รองรับมิติข้อมูลชั่วคราวเพิ่มเติมต่อไปนี้

      • 7DayTotals – ระบบจะรวบรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลสําหรับ 7 วัน
      • 30DayTotals – ระบบจะรวบรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลเป็นเวลา 30 วัน
      • month – ข้อมูลในรายงานจะรวบรวมตามเดือนปฏิทิน

      ในทํานองเดียวกัน เราได้อัปเดตส่วนรายงานที่พร้อมใช้งานให้สอดคล้องกับการรองรับ API สําหรับรายงานที่ใช้มิติข้อมูลเหล่านี้

    • ส่วนมิติข้อมูลการรายงานเอนทิตีได้รับการอัปเดตให้ทราบว่าคําขอ API ในการเรียกรายงานเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูลใดมิติข้อมูลหนึ่งต่อไปนี้ (video, channel หรือ show) หรือชุดค่าผสมของมิติข้อมูล claimedStatus และ uploaderType ที่รองรับ

    • ตอนนี้ API รองรับตัวเลือกการจัดเรียงใหม่ 2 แบบสําหรับรายงานวิดีโอยอดนิยม รายงานเหล่านี้ซึ่งมีให้ใช้งานเป็นรายงานของช่องหรือรายงานเจ้าของเนื้อหาจะมีเมตริก (ยอดดู ความคิดเห็น การชอบ ฯลฯ) ตามประเทศและแจกแจงเมตริกเหล่านั้นตามวิดีโอ ปัจจุบันคุณสามารถจัดเรียงรายงานเหล่านี้ตามจํานวนผู้ใช้ที่ติดตามหรือเลิกติดตามช่องจากหน้าสําหรับดูของวิดีโอ

    • มีการอัปเดตคําจํากัดความของเมตริก subscribersGained และ subscribersLost เพื่ออธิบายว่าช่องอาจเพิ่มหรือสูญเสียผู้ติดตามในที่ต่างๆ เช่น หน้าสําหรับดูวิดีโอ หน้าช่อง รวมถึงคําแนะนําที่จะปรากฏในหน้าแรกของ YouTube เมื่อเมตริกเหล่านี้ปรากฏในรายงานเฉพาะวิดีโอ จะมีเฉพาะสถิติจากหน้าสําหรับดูของวิดีโอที่ระบุเท่านั้น