Videos

วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง videos.insert จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดอยู่ในโหมดดูแบบส่วนตัว หากต้องการยกเลิกการจำกัดนี้ โปรเจ็กต์ API แต่ละโปรเจ็กต์ต้องได้รับการตรวจสอบเพื่อยืนยันการปฏิบัติตามข้อกำหนดในการให้บริการ โปรดดูรายละเอียดเพิ่มเติมที่ประวัติการแก้ไข API

ทรัพยากร video แสดงถึงวิดีโอ YouTube

วิธีการ

API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร videos รายการ

getRating
เรียกข้อมูลการจัดประเภทที่ผู้ใช้ที่ได้รับอนุญาตให้ไปยังรายการวิดีโอที่ระบุ ลองใช้เลย
list
แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
แทรก
อัปโหลดวิดีโอไปยัง YouTube และตั้งค่าข้อมูลเมตาของวิดีโอ (ไม่บังคับ)
อัปเดต
อัปเดตข้อมูลเมตาของวิดีโอ ลองใช้เลย
ลบ
ลบวิดีโอ YouTube ลองใช้เลย
อัตรา [rate]
เพิ่มคะแนนการกดชอบหรือไม่ชอบในวิดีโอหรือนำการให้คะแนนออกจากวิดีโอ ลองใช้เลย
reportAbuse
รายงานวิดีโอเนื่องจากมีเนื้อหาที่เป็นการละเมิด ลองใช้เลย

การนำเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร videos

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#video
etag etag
Etag ของแหล่งข้อมูลนี้
id string
รหัสที่ YouTube ใช้ในการระบุวิดีโอแบบไม่ซ้ำ
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับวิดีโอ เช่น ชื่อ คำอธิบาย และหมวดหมู่
snippet.publishedAt datetime
วันที่และเวลาที่เผยแพร่วิดีโอ โปรดทราบว่าเวลาดังกล่าวอาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ เช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัว แล้วเปลี่ยนเป็นแบบสาธารณะในภายหลัง พร็อพเพอร์ตี้นี้จะระบุเวลาที่ทำให้วิดีโอเป็นแบบสาธารณะ

มีกรณีพิเศษ 2 กรณีดังนี้
  • หากวิดีโอได้รับการอัปโหลดเป็นวิดีโอส่วนตัวและเจ้าของช่องดึงข้อมูลเมตาของวิดีโอ ค่าพร็อพเพอร์ตี้จะระบุวันที่และเวลาที่อัปโหลดวิดีโอ
  • หากอัปโหลดวิดีโอเป็นวิดีโอที่ไม่เป็นสาธารณะ ค่าพร็อพเพอร์ตี้จะระบุวันที่และเวลาที่อัปโหลดวิดีโอด้วย ในกรณีนี้ ทุกคนที่ทราบรหัสวิดีโอที่ไม่ซ้ำกันของวิดีโอจะสามารถเรียกข้อมูลเมตาของวิดีโอได้
ค่าจะระบุไว้ในรูปแบบ ISO 8601
snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่มีการอัปโหลดวิดีโอโดยไม่ซ้ำกัน
snippet.title string
ชื่อวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 100 อักขระ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ > คุณต้องตั้งค่าพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และกำลังอัปเดตส่วน snippet ของทรัพยากร video
snippet.description string
คำอธิบายวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 5,000 ไบต์และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
snippet.thumbnails object
แผนที่ของภาพขนาดย่อที่เกี่ยวข้องกับวิดีโอ สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ
snippet.thumbnails.(key) object
คีย์-ค่าที่ใช้ได้มีดังนี้
  • default – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นของวิดีโอหรือทรัพยากรที่อ้างอิงไปยังวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – ภาพปกเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้จะกว้าง 240 พิกเซลและสูง 240 พิกเซล
  • high – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 800 พิกเซลและสูง 800 พิกเซล
  • standard – รูปภาพขนาดย่อเวอร์ชันความละเอียดที่สูงกว่ารูปภาพความละเอียด high ภาพนี้พร้อมใช้งานสำหรับบางวิดีโอและแหล่งข้อมูลอื่นๆ ที่อ้างถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล
  • maxres – ภาพปกเวอร์ชันที่มีความละเอียดสูงสุด ขนาดภาพนี้ใช้ได้กับวิดีโอบางรายการและทรัพยากรอื่นๆ ที่อ้างถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 1280 พิกเซลและสูง 720 พิกเซล
snippet.thumbnails.(key).url string
URL ของรูปภาพ
snippet.thumbnails.(key).width unsigned integer
ความกว้างของรูปภาพ
snippet.thumbnails.(key).height unsigned integer
ความสูงของรูปภาพ
snippet.channelTitle string
ชื่อช่องสำหรับช่องที่เป็นเจ้าของวิดีโอ
snippet.tags[] list
รายการแท็กคีย์เวิร์ดที่เกี่ยวข้องกับวิดีโอ แท็กอาจมีช่องว่าง ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 500 อักขระ โปรดคำนึงถึงกฎต่อไปนี้ซึ่งเกี่ยวกับวิธีคำนวณจำนวนอักขระสูงสุด:
  • ค่าพร็อพเพอร์ตี้คือรายการ และคอมมาคั่นระหว่างรายการต่างๆ ในรายการจะนับรวมในขีดจํากัด
  • หากแท็กมีการเว้นวรรค เซิร์ฟเวอร์ API จะจัดการค่าแท็กเสมือนว่ารวมอยู่ในเครื่องหมายคำพูด และเครื่องหมายคำพูดจะนับรวมในจำนวนอักขระสูงสุด ดังนั้น ตามวัตถุประสงค์ของจำนวนอักขระสูงสุด แท็ก Foo-Baz จึงมีอักขระ 7 ตัว แต่แท็ก Foo Baz ประกอบด้วยอักขระ 9 ตัว
snippet.categoryId string
หมวดหมู่วิดีโอของ YouTube ที่เชื่อมโยงกับวิดีโอ คุณต้องตั้งค่าให้กับพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และอัปเดตส่วน snippet ของทรัพยากร video
snippet.liveBroadcastContent string
ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่หรือดำเนินอยู่ หรือเป็น "ไม่มี" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กำลังจะเผยแพร่/ที่ดำเนินอยู่

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • live
  • none
  • upcoming
snippet.defaultLanguage string
ภาษาของข้อความในพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร video
snippet.localized object
ออบเจ็กต์ snippet.localized มีชื่อและคำอธิบายวิดีโอที่แปลแล้ว หรือชื่อเป็นภาษาเริ่มต้นสำหรับข้อมูลเมตาของวิดีโอ
  • ข้อความที่แปลแล้วจะส่งคืนในตัวอย่างแหล่งข้อมูล หากคำขอ videos.list ใช้พารามิเตอร์ hl เพื่อระบุภาษาที่ควรแสดงผลข้อความที่แปลแล้วและข้อความที่แปลแล้วใช้ได้ในภาษานั้น
  • จะแสดงข้อมูลเมตาสำหรับภาษาเริ่มต้น หากไม่ได้ระบุค่าพารามิเตอร์ hl หรือระบุค่าไว้ แต่ข้อมูลเมตาที่แปลแล้วไม่พร้อมใช้งานสำหรับภาษาที่ระบุ
พร็อพเพอร์ตี้มีค่าแบบอ่านอย่างเดียว ใช้ออบเจ็กต์ localizations เพื่อเพิ่ม อัปเดต หรือลบชื่อที่แปลแล้ว
snippet.localized.title string
ชื่อวิดีโอที่แปล
snippet.localized.description string
คำอธิบายวิดีโอที่แปลแล้ว
snippet.defaultAudioLanguage string
พร็อพเพอร์ตี้ default_audio_language ระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ
contentDetails object
ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาวิดีโอ รวมถึงความยาวของวิดีโอ และตัวบ่งชี้ว่าวิดีโอมีคำบรรยายไหม
contentDetails.duration string
ความยาวของวิดีโอ ค่าพร็อพเพอร์ตี้คือระยะเวลา ISO 8601 ตัวอย่างเช่น สำหรับวิดีโอที่มีความยาวอย่างน้อย 1 นาทีและมีความยาวน้อยกว่า 1 ชั่วโมง ระยะเวลาจะอยู่ในรูปแบบ PT#M#S ซึ่งตัวอักษร PT ระบุว่าค่านี้ระบุระยะเวลา และตัวอักษร M และ S หมายถึงความยาวเป็นนาทีและวินาที ตามลำดับ อักขระ # ที่อยู่ตามหลังตัวอักษร M และ S เป็นจำนวนเต็มที่ระบุจำนวนนาที (หรือวินาที) ของวิดีโอ ตัวอย่างเช่น ค่า PT15M33S บ่งบอกว่าวิดีโอยาว 15 นาที 33 วินาที

หากวิดีโอมีความยาวอย่างน้อย 1 ชั่วโมง ระยะเวลาจะอยู่ในรูปแบบ PT#H#M#S ซึ่ง # นำหน้าตัวอักษร H ระบุความยาวของวิดีโอเป็นชั่วโมง และรายละเอียดอื่นๆ ทั้งหมดเหมือนกันกับที่อธิบายไว้ข้างต้น หากวิดีโอมีความยาวอย่างน้อย 1 วัน ตัวอักษร P และ T จะแยกกัน และรูปแบบของค่าคือ P#DT#H#M#S โปรดดูรายละเอียดทั้งหมดในข้อมูลจำเพาะของ ISO 8601
contentDetails.dimension string
ระบุว่าวิดีโอพร้อมให้รับชมในรูปแบบ 3 มิติหรือ 2 มิติ
contentDetails.definition string
ระบุว่าวิดีโอมีความละเอียดสูง (HD) หรือมีเฉพาะความละเอียดมาตรฐาน

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • hd
  • sd
contentDetails.caption string
ระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • false
  • true
contentDetails.licensedContent boolean
ระบุว่าวิดีโอแสดงถึงเนื้อหาที่ได้รับอนุญาตหรือไม่ ซึ่งหมายความว่ามีการอัปโหลดเนื้อหาไปยังช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube แล้วอ้างสิทธิ์โดยพาร์ทเนอร์รายดังกล่าว
contentDetails.regionRestriction object
ออบเจ็กต์ regionRestriction มีข้อมูลเกี่ยวกับประเทศที่ผู้ใช้ดูวิดีโอได้ (หรือไม่รับชม) ออบเจ็กต์จะมีพร็อพเพอร์ตี้ contentDetails.regionRestriction.allowed หรือพร็อพเพอร์ตี้ contentDetails.regionRestriction.blocked
contentDetails.regionRestriction.allowed[] list
รายการรหัสภูมิภาคที่ระบุประเทศที่ผู้ใช้ดูวิดีโอได้ หากมีพร็อพเพอร์ตี้นี้อยู่และประเทศที่ไม่ได้อยู่ในค่า ระบบจะบล็อกวิดีโอไม่ให้แสดงในประเทศนั้น หากมีพร็อพเพอร์ตี้นี้และมีรายการที่ว่างเปล่า ระบบจะบล็อกวิดีโอในทุกประเทศ
contentDetails.regionRestriction.blocked[] list
รายการรหัสภูมิภาคที่ระบุประเทศที่วิดีโอถูกบล็อก หากมีพร็อพเพอร์ตี้นี้อยู่และประเทศที่ไม่ได้อยู่ในค่า แสดงว่าวิดีโอจะดูได้ในประเทศนั้น หากมีพร็อพเพอร์ตี้นี้และมีรายการที่ว่างเปล่า แสดงว่าวิดีโอดูได้ในทุกประเทศ
contentDetails.contentRating object
ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ
contentDetails.contentRating.acbRating string
การจัดประเภทของ Australian Classification Board (ACB) หรือ Australian Communications and Media Authority (ACMA) ของวิดีโอ การจัดประเภทของ ACMA ใช้ในการแยกประเภทรายการทีวีสำหรับเด็ก

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • acbC – โปรแกรมที่จัดอยู่ในหมวดหมู่ C จากหน่วยงานด้านการสื่อสารและสื่อแห่งออสเตรเลีย (Australian Communications and Media Authority) โปรแกรมเหล่านี้เหมาะสำหรับเด็ก (ที่ไม่ใช่วัยก่อนเข้าเรียน) ที่มีอายุไม่เกิน 14 ปี
  • acbE - ตะวันออก
  • acbG - ประตู
  • acbM - ล้าน
  • acbMa15plus – MA15+
  • acbP – โปรแกรมที่จัดอยู่ในหมวดหมู่ P จากหน่วยงานด้านการสื่อสารและสื่อแห่งออสเตรเลีย (Australian Communications and Media Authority) โปรแกรมเหล่านี้มีไว้สำหรับเด็กก่อนวัยเรียน
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
การจัดประเภทของวิดีโอจาก Autorità per le Garanzie nelle Comunicazioni (AGCOM) ของอิตาลี

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • agcomT - ตัน
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
การจัดประเภทของ Anatel (Asociación Nacional de Televisión) ของวิดีโอสำหรับโทรทัศน์ในชิลี

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • anatelA - ก
  • anatelF – ศ.
  • anatelI – ฉัน
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 - I-7
  • anatelR - R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
การจัดประเภทของ British Board of Film Classification (BBFC) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • bbfc12 – 12 ปี
  • bbfc12a – 12A
  • bbfc15 – 15 คน
  • bbfc18 – 18 ปี
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
การจัดประเภทวิดีโอจากคณะกรรมการเซ็นเซอร์ภาพยนตร์และวิดีโอแห่งประเทศไทย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • bfvc13 – 13 ปี
  • bfvc15 – 15 คน
  • bfvc18 – 18 ปี
  • bfvc20 – 20 คน
  • bfvcB – B
  • bfvcE - ตะวันออก
  • bfvcG - ประตู
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทสื่อของออสเตรีย (Bundesministerium für Unterricht, Kunst und Kultur)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • bmukk10 – 10 ปีขึ้นไป
  • bmukk12 – 12 ปีขึ้นไป
  • bmukk14 – 14 ปีขึ้นไป
  • bmukk16 – 16 ปีขึ้นไป
  • bmukk6 – 6 ปีขึ้นไป
  • bmukk8 – 8 ปีขึ้นไป
  • bmukkAa – ไม่จำกัด
  • bmukkUnrated
contentDetails.contentRating.catvRating string
ระบบการจัดประเภทสำหรับแคนาดาทีวี - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศเป็นภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • catv14plus – 14 ปีขึ้นไป
  • catv18plus – 18 ปีขึ้นไป
  • catvC - เซลเซียส
  • catvC8 - C8
  • catvG - ประตู
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
การจัดประเภทวิดีโอจากคณะกรรมาธิการด้านวิทยุและโทรทัศน์ (CRTC) ของแคนาดาสำหรับการออกอากาศภาษาฝรั่งเศสแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • catvfr13plus – 13 ปีขึ้นไป
  • catvfr16plus – 16 ปีขึ้นไป
  • catvfr18plus – 18 ปีขึ้นไป
  • catvfr8plus – 8 ปีขึ้นไป
  • catvfrG - ประตู
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
การจัดประเภทของ Central Board of Film Certification (CBFC - India) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cbfcA - ก
  • cbfcS – อา.
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
การให้คะแนน Consejo de Calificación Cinematográfica (ชิลี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • ccc14 – 14 ปีขึ้นไป
  • ccc18 – 18 ปีขึ้นไป
  • ccc18s – 18+ - Contenido pornográfico
  • ccc18v – 18+ - Contenido Excel Excesivamenteที่มีความรุนแรง
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – เอกวาดอร์ Todo
  • cccUnrated
contentDetails.contentRating.cceRating string
การจัดประเภทวิดีโอจาก Comissão de Classificação de Espect imagesculos ของโปรตุเกส

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cceM12 – 12 ปี
  • cceM14 – 14 ปี
  • cceM16 – 16 ปี
  • cceM18 – 18 ปี
  • cceM4-4 คน
  • cceM6 – 6 คน
  • cceUnrated
contentDetails.contentRating.chfilmRating string
การจัดประเภทของวิดีโอในสวิตเซอร์แลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • chfilm0 - 0
  • chfilm12 – 12 ปี
  • chfilm16 – 16 ปี
  • chfilm18 – 18 ปี
  • chfilm6 – 6 คน
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
การจัดประเภทของระบบการจัดประเภทโฮมวิดีโอของแคนาดา (CHVRS) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE - ตะวันออก
  • chvrsG - ประตู
  • chvrsPg – PG
  • chvrsR - R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
การจัดประเภทของวิดีโอจาก Commission de Contrôle des Films (เบลเยียม)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cicfE - ตะวันออก
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
การจัดประเภทของวิดีโอจาก CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) ของโรมาเนีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cna12 – 12 ปี
  • cna15 – 15 คน
  • cna18 – 18 ปี
  • cna18plus – 18 ปีขึ้นไป
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
ระบบการจัดประเภทในฝรั่งเศส - Commission de engagement Cinematographique

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cnc10 – 10 คน
  • cnc12 – 12 ปี
  • cnc16 – 16 ปี
  • cnc18 – 18 ปี
  • cncE - ตะวันออก
  • cncT - ตัน
  • cncUnrated
contentDetails.contentRating.csaRating string
การจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศส ซึ่งจะให้คะแนนเนื้อหาที่ออกอากาศ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • csa10 – 10 คน
  • csa12 – 12 ปี
  • csa16 – 16 ปี
  • csa18 – 18 ปี
  • csaInterdiction – ตัดช่วง
  • csaT - ตัน
  • csaUnrated
contentDetails.contentRating.cscfRating string
การจัดประเภทของวิดีโอจาก Commission de surveillance de laคำหลัก des Films (CSCF) ของลักเซมเบิร์ก:

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cscf12 – 12 ปี
  • cscf16 – 16 ปี
  • cscf18 – 18 ปี
  • cscf6 – 6 คน
  • cscf9 - 9 คน
  • cscfA - ก
  • cscfAl – แอละแบมา
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
การจัดประเภทของวิดีโอในสาธารณรัฐเช็ก

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • czfilm12 – 12 ปี
  • czfilm14 – 14 ปี
  • czfilm18 – 18 ปี
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
การจัดประเภทของวิดีโอ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • djctq10 – 10 คน
  • djctq12 – 12 ปี
  • djctq14 – 14 ปี
  • djctq16 – 16 ปี
  • djctq18 – 18 ปี
  • djctqL – ลิตร
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
เหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภทเป็น DJCQT (บราซิล)
contentDetails.contentRating.ecbmctRating string
ระบบการจัดประเภทในตุรกี - คณะกรรมการการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยว

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • ecbmct13a – 13A
  • ecbmct13plus – 13 ปีขึ้นไป
  • ecbmct15a – 15A
  • ecbmct15plus – 15 ปีขึ้นไป
  • ecbmct18plus – 18 ปีขึ้นไป
  • ecbmct7a – 7A
  • ecbmct7plus – 7 ปีขึ้นไป
  • ecbmctG - ประตู
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6 ปีขึ้นไป
  • ecbmct10a – 10A
  • ecbmct10plus – 10 ปีขึ้นไป
  • ecbmct16plus – 16 ปีขึ้นไป
contentDetails.contentRating.eefilmRating string
การจัดประเภทของวิดีโอในเอสโตเนีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • eefilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-12)
  • eefilmK14 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-14)
  • eefilmK16 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-16)
  • eefilmK6 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-6)
  • eefilmL – ลิตร
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
การจัดประเภทของวิดีโอในอียิปต์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • egfilm18 – 18 ปี
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
การจัดประเภทของ Eirin (映倫) ของวิดีโอ Eirin เป็นระบบการจัดประเภทของญี่ปุ่น

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • eirinG - ประตู
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
การจัดประเภทวิดีโอจากคณะกรรมการเซ็นเซอร์ภาพยนตร์ของมาเลเซีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • fcbm13 – 13 ปี
  • fcbm16 – 16 ปี
  • fcbm18 – 18 ปี
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18 สิงคโปร์
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
การจัดประเภทวิดีโอจากสำนักงานภาพยนตร์ หนังสือพิมพ์ และบทความของฮ่องกง

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • fcoI – ฉัน
  • fcoIi - 2
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – 3
  • fcoUnrated
contentDetails.contentRating.fmocRating string
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 2 พฤศจิกายน 2015 โปรดใช้พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating แทน

การจัดประเภทวิดีโอ Centre Nation du cinéma et de l'image animé (กระทรวงวัฒนธรรมของฝรั่งเศส)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • fmoc10 – 10 คน
  • fmoc12 – 12 ปี
  • fmoc16 – 16 ปี
  • fmoc18 – 18 ปี
  • fmocE - ตะวันออก
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
การจัดประเภทวิดีโอจากคณะกรรมการฟิล์มและสิ่งพิมพ์ของแอฟริกาใต้

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • fpb10 – 10 คน
  • fpb1012Pg – 10-12PG
  • fpb13 – 13 ปี
  • fpb16 – 16 ปี
  • fpb18 – 18 ปี
  • fpb79Pg – 7-9PG
  • fpbA - ก
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 - X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
เหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภทเป็น FPB (แอฟริกาใต้)
contentDetails.contentRating.fskRating string
การจัดประเภทวิดีโอ Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - เยอรมนี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
การจัดประเภทของวิดีโอในกรีซ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • grfilmE - ตะวันออก
  • grfilmK - K
  • grfilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-12)
  • grfilmK13 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-13)
  • grfilmK15 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-15)
  • grfilmK17 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-17)
  • grfilmK18 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-18)
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
การให้คะแนน Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spain) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • icaa12 – 12 ปี
  • icaa13 – 13 ปี
  • icaa16 – 16 ปี
  • icaa18 – 18 ปี
  • icaa7-7 คน
  • icaaApta – APTA
  • icaaUnrated
  • icaaX - X
contentDetails.contentRating.ifcoRating string
การจัดประเภทของสำนักงานการจัดประเภทภาพยนตร์ไอร์แลนด์ (IFCO - ไอร์แลนด์) ของวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • ifco12 – 12 ปี
  • ifco12a – 12A
  • ifco15 – 15 คน
  • ifco15a – 15A
  • ifco16 – 16 ปี
  • ifco18 – 18 ปี
  • ifcoG - ประตู
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
การจัดประเภทของวิดีโอในอิสราเอล

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • ilfilm12 – 12 ปี
  • ilfilm16 – 16 ปี
  • ilfilm18 – 18 ปี
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
การจัดประเภท INCAA ของวิดีโอ (Instituto Nacional de Cine y Artes Audiovisuales - Argentina)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para canores de 18 años, de exhibición Condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของเคนยา

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • kfcb16plus – 16 ปี
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18 ปี
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • kijkwijzer12 – 12 ปี
  • kijkwijzer14 – 14 ปี
  • kijkwijzer16 – 16 ปี
  • kijkwijzer18 – 18 ปี
  • kijkwijzer6 – 6 คน
  • kijkwijzer9 - 9 คน
  • kijkwijzerAl – แอละแบมา
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
การจัดประเภทของคณะกรรมการจัดระดับความเหมาะสมเนื้อหาสื่อของเกาหลี (영알물ؼ사型號) ของวิดีโอ KMRB ให้คะแนนวิดีโอในเกาหลีใต้

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • kmrb12plus – 12세 이미 여람
  • kmrb15plus – 15세 이미 電람จะทำอย่างไร
  • kmrbAll – 電체람
  • kmrbR – 청소년 ค่ำ람불ของคุณจะปรากฏ
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
การจัดประเภทวิดีโอจาก Lembaga Sensor Film ของอินโดนีเซีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • lsf13 – 13 ปี
  • lsf17 – 17 ปี
  • lsf21 – 21
  • lsfA - ก
  • lsfBo – โบลิเวีย
  • lsfD - D
  • lsfR - R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของมอลตา

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • mccaa12 – 12 ปี
  • mccaa12a – 12A
  • mccaa14 – 14 - การจัดประเภทนี้ถูกนำออกจากโครงสร้างการจัดประเภทแบบใหม่ซึ่งเริ่มใช้ในปี 2013
  • mccaa15 – 15 คน
  • mccaa16 – 16 - การจัดประเภทนี้ถูกนำออกจากโครงสร้างการจัดประเภทแบบใหม่ซึ่งเริ่มใช้ในปี 2013
  • mccaa18 – 18 ปี
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
การจัดประเภทวิดีโอจากสถาบันภาพยนตร์แห่งเดนมาร์ก (Det Danske Filminstitut) Media Council for Children and Young People

ค่าที่ถูกต้องสำหรับที่พักดังกล่าวมีดังนี้
  • mccyp11 – 11 คน
  • mccyp15 – 15 คน
  • mccyp7-7 คน
  • mccypA - ก
  • mccypUnrated
contentDetails.contentRating.mcstRating string
ระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • mcst0 - 0
  • mcst16plus – 16 ปีขึ้นไป
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK - K
contentDetails.contentRating.mdaRating string
การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (MDA) ของสิงคโปร์ กล่าวอย่างเจาะจงคือ คณะกรรมการกำกับภาพยนตร์ (BFC) ของสิงคโปร์

ค่าที่ถูกต้องสำหรับที่พักดังกล่าวมีดังนี้
  • mdaG - ประตู
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
การจัดประเภทของวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานสื่อของนอร์เวย์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • medietilsynet11 – 11 คน
  • medietilsynet12 – 12 ปี
  • medietilsynet15 – 15 คน
  • medietilsynet18 – 18 ปี
  • medietilsynet6 – 6 คน
  • medietilsynet7-7 คน
  • medietilsynet9 - 9 คน
  • medietilsynetA - ก
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
การจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) ของฟินแลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • meku12 – 12 ปี
  • meku16 – 16 ปี
  • meku18 – 18 ปี
  • meku7-7 คน
  • mekuS – อา.
  • mekuUnrated
contentDetails.contentRating.mibacRating string
การจัดประเภทวิดีโอจาก Ministero dei Beni e delle Attività Culturali e del Turismo (อิตาลี)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
การจัดประเภทวิดีโอของรัฐ Ministerio de Cultura (โคลอมเบีย)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • moc12 – 12 ปี
  • moc15 – 15 คน
  • moc18 – 18 ปี
  • moc7-7 คน
  • mocBanned – ถูกแบน
  • mocE - ตะวันออก
  • mocT - ตัน
  • mocUnrated
  • mocX - X
contentDetails.contentRating.moctwRating string
การจัดประเภทวิดีโอจากกระทรวงวัฒนธรรมของไต้หวัน (化部)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • moctwG - ประตู
  • moctwP – P
  • moctwPg – PG
  • moctwR - R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
การจัดประเภทของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • mpaaG - ประตู
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR - R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
การจัดประเภทตัวอย่างภาพยนตร์และการแสดงตัวอย่างภาพยนตร์ของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • mpaatGb – GB (Green Band - อนุมัติสำหรับผู้ชมทั้งหมด)
  • mpaatRb – RB (สายสีแดง - แนะนำสำหรับอายุ 17 ปีขึ้นไป)
contentDetails.contentRating.mtrcbRating string
การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาและจัดประเภทภาพยนตร์และโทรทัศน์ (ฟิลิปปินส์)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • mtrcbG - ประตู
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX - X
contentDetails.contentRating.nbcRating string
การจัดประเภทวิดีโอจากสำนักงานการจัดประเภทแห่งชาติมัลดีฟส์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • nbc12plus – 12 ปีขึ้นไป
  • nbc15plus – 15 ปีขึ้นไป
  • nbc18plus – 18 ปีขึ้นไป
  • nbc18plusr – 18+R
  • nbcG - ประตู
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
การจัดประเภทวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • nfrcA - ก
  • nfrcB – B
  • nfrcC - เซลเซียส
  • nfrcD - D
  • nfrcUnrated
  • nfrcX - X
contentDetails.contentRating.nfvcbRating string
การจัดประเภทวิดีโอจากคณะกรรมการกำกับภาพยนตร์และวิดีโอแห่งชาติของไนจีเรีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • nfvcb12 – 12 ปี
  • nfvcb12a – 12A
  • nfvcb15 – 15 คน
  • nfvcb18 – 18 ปี
  • nfvcbG - ประตู
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
การจัดประเภทวิดีโอจาก Nacionãlais Kino centrs (National Film Centre of Latvia)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • nkclv12plus – 12 ปีขึ้นไป
  • nkclv18plus – 18 ปีขึ้นไป
  • nkclv7plus – 7 ปีขึ้นไป
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
การจัดประเภทของ Office of Film and Literature Classification (OFLC - นิวซีแลนด์) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • oflcG - ประตู
  • oflcM - ล้าน
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
การจัดประเภทของวิดีโอในเปรู

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • pefilm14 – 14 ปี
  • pefilm18 – 18 ปี
  • pefilmPg – PG
  • pefilmPt – โปรตุเกส
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
การจัดประเภทของวิดีโอในเวเนซุเอลา

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • resorteviolenciaA - ก
  • resorteviolenciaB – B
  • resorteviolenciaC - เซลเซียส
  • resorteviolenciaD - D
  • resorteviolenciaE - ตะวันออก
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
การจัดประเภทของคณะกรรมการทั่วไปด้านวิทยุ โทรทัศน์ และการถ่ายทำ (เม็กซิโก) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • rtcA - ก
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC - เซลเซียส
  • rtcD - D
  • rtcUnrated
contentDetails.contentRating.rteRating string
การจัดประเภทวิดีโอจาก Raidió Teilifís Éireann ของไอร์แลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • rteCh – สวิตเซอร์แลนด์
  • rteGa – GA
  • rteMa – แมสซาชูเซตส์
  • rtePs – การตัดสินด้วยการยิงจุดโทษ
  • rteUnrated
contentDetails.contentRating.russiaRating string
การจัดประเภทวิดีโอของสำนักทะเบียนภาพยนตร์แห่งชาติสหพันธรัฐรัสเซีย (MKRF - รัสเซีย) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • russia0 – 0+
  • russia12 – 12 ปีขึ้นไป
  • russia16 – 16 ปีขึ้นไป
  • russia18 – 18 ปีขึ้นไป
  • russia6 – 6 ปีขึ้นไป
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
การจัดประเภทของวิดีโอในสโลวาเกีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • skfilmG - ประตู
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
การจัดประเภทของวิดีโอในไอซ์แลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • smais12 – 12 ปี
  • smais14 – 14 ปี
  • smais16 – 16 ปี
  • smais18 – 18 ปี
  • smais7-7 คน
  • smaisL – ลิตร
  • smaisUnrated
contentDetails.contentRating.smsaRating string
การจัดประเภทวิดีโอจาก Statens medieråd (Sweden's National Media Council)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • smsa11 – 11 คน
  • smsa15 – 15 คน
  • smsa7-7 คน
  • smsaA – ทุกวัย
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
การจัดประเภท TV Parental Guidelines (TVPG)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – ทีวี-14
contentDetails.contentRating.ytRating string
การจัดประเภทที่ YouTube ใช้เพื่อระบุเนื้อหาที่จำกัดอายุผู้ชม

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • ytAgeRestricted
contentDetails.projection string
ระบุรูปแบบการฉายภาพของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
ระบุว่าผู้อัปโหลดวิดีโอได้ใส่ภาพขนาดย่อที่กำหนดเองสำหรับวิดีโอหรือไม่ พร็อพเพอร์ตี้นี้แสดงต่อผู้อัปโหลดวิดีโอเท่านั้น
status object
ออบเจ็กต์ status มีข้อมูลเกี่ยวกับการอัปโหลด การประมวลผล และสถานะความเป็นส่วนตัวของวิดีโอ
status.uploadStatus string
สถานะของวิดีโอที่อัปโหลด

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
ค่านี้จะอธิบายสาเหตุที่ทำให้อัปโหลดวิดีโอไม่สำเร็จ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าอัปโหลดไม่สำเร็จ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
ค่านี้อธิบายถึงสาเหตุที่ YouTube ปฏิเสธวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดถูกปฏิเสธ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
สถานะความเป็นส่วนตัวของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • private
  • public
  • unlisted
status.publishAt datetime
วันที่และเวลาที่กำหนดให้วิดีโอเผยแพร่ โดยจะตั้งค่าได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็น "ส่วนตัว" ค่าจะระบุไว้ในรูปแบบ ISO 8601 โปรดทราบอีก 2 ประเด็นต่อไปนี้เกี่ยวกับลักษณะการทำงานของคุณสมบัตินี้:
  • หากคุณตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.update คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้ว
  • หากคำขอของคุณกำหนดเวลาให้เผยแพร่วิดีโอในช่วงเวลาใดเวลาหนึ่งในอดีต ระบบจะเผยแพร่วิดีโอทันที ดังนั้น ผลของการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เป็นวันที่และเวลาในอดีตจะเหมือนกับการเปลี่ยน privacyStatus ของวิดีโอจาก private เป็น public
status.license string
ใบอนุญาตของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • creativeCommon
  • youtube
status.embeddable boolean
ค่านี้ระบุว่าสามารถฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่
status.publicStatsViewable boolean
ค่านี้ระบุว่าสถิติของวิดีโอแบบขยายในหน้าดูวิดีโอเป็นข้อมูลที่เปิดเผยต่อสาธารณะหรือไม่ สถิติดังกล่าวจะสามารถดูได้โดยค่าเริ่มต้น และสถิติต่างๆ เช่น จำนวนการดูและการให้คะแนนของวิดีโอ จะยังคงปรากฏแบบสาธารณะ แม้ว่าค่าของคุณสมบัตินี้จะตั้งค่าเป็น false
status.madeForKids boolean
ค่านี้ระบุว่าวิดีโอมีการมีเด็กเป็นกลุ่มเป้าหมายหรือไม่ และมีสถานะ "สร้างมาเพื่อเด็ก" ในปัจจุบันของวิดีโอ เช่น อาจกำหนดสถานะตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube
status.selfDeclaredMadeForKids boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องกำหนดได้ว่าวิดีโอมีเด็กเป็นกลุ่มเป้าหมาย ในคำขอ videos.list ระบบจะแสดงค่าพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คำขอ API ดังกล่าวเท่านั้น
statistics object
ออบเจ็กต์ statistics มีสถิติเกี่ยวกับวิดีโอ
statistics.viewCount unsigned long
จำนวนครั้งที่มีการดูวิดีโอ
statistics.likeCount unsigned long
จำนวนผู้ใช้ที่ระบุว่าชอบวิดีโอ
statistics.dislikeCount unsigned long
หมายเหตุ: พร็อพเพอร์ตี้ statistics.dislikeCount ได้เป็นแบบส่วนตัวเมื่อวันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะรวมอยู่ในการตอบกลับจาก API ต่อเมื่อคำขอ API ได้รับการตรวจสอบสิทธิ์โดยเจ้าของวิดีโอเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไข

จำนวนผู้ใช้ที่ระบุว่าไม่ชอบวิดีโอ
statistics.favoriteCount unsigned long
หมายเหตุ: เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว การเลิกใช้งานนี้จะมีผลตั้งแต่วันที่ 28 สิงหาคม 2015 ตอนนี้ค่าของพร็อพเพอร์ตี้จะตั้งค่าเป็น 0 เสมอ
statistics.commentCount unsigned long
จำนวนความคิดเห็นในวิดีโอ
player object
ออบเจ็กต์ player มีข้อมูลที่คุณจะใช้เล่นวิดีโอในโปรแกรมเล่นแบบฝัง
player.embedHtml string
แท็ก <iframe> ที่ฝังโปรแกรมเล่นที่เล่นวิดีโอ
  • หากคำขอ API เพื่อเรียกข้อมูลทรัพยากรระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth ระบบจะปรับขนาดของโปรแกรมเล่นแบบฝังเพื่อให้เป็นไปตามข้อกำหนดของ maxHeight และ/หรือ maxWidth
  • หากไม่ทราบอัตราส่วนของวิดีโอ โปรแกรมเล่นแบบฝังจะมีค่าเริ่มต้นเป็นรูปแบบ 4:3
player.embedHeight long
ความสูงของโปรแกรมเล่นแบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงพร็อพเพอร์ตี้นี้เมื่อคำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอเท่านั้น
player.embedWidth long
ความกว้างของโปรแกรมเล่นแบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงพร็อพเพอร์ตี้นี้เมื่อคำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอเท่านั้น
topicDetails object
ออบเจ็กต์ topicDetails สรุปข้อมูลเกี่ยวกับหัวข้อที่เชื่อมโยงกับวิดีโอ

สำคัญ: ดูคำจำกัดความของพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] และ topicDetails.topicIds[] รวมถึงประวัติการแก้ไขเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงที่กำลังจะเกิดขึ้นที่เกี่ยวข้องกับรหัสหัวข้อ
topicDetails.topicIds[] list
สำคัญ: พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 10 พฤศจิกายน 2016 API จะไม่แสดงค่าของพร็อพเพอร์ตี้นี้อีกต่อไป และตอนนี้ค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] จะแสดงหัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอ
topicDetails.relevantTopicIds[] list
รายการรหัสหัวข้อที่เกี่ยวข้องกับวิดีโอ

พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วเมื่อวันที่ 10 พฤศจิกายน 2016 โดยจะรองรับการใช้งานจนถึงวันที่ 10 พฤศจิกายน 2017

สำคัญ: เนื่องจากการเลิกใช้งาน Freebase และ Freebase API รหัสหัวข้อจึงเริ่มทำงานต่างออกไปตั้งแต่วันที่ 27 กุมภาพันธ์ 2017 ในช่วงนั้น YouTube ได้เริ่มแสดงรหัสหัวข้อที่มีการดูแลจัดการจำนวนหนึ่ง

topicDetails.topicCategories[] list
รายการ URL ของ Wikipedia ที่ระบุรายละเอียดระดับสูงเกี่ยวกับเนื้อหาของวิดีโอ
recordingDetails object
ออบเจ็กต์ recordingDetails สรุปข้อมูลเกี่ยวกับตำแหน่ง วันที่ และที่อยู่ที่มีการบันทึกวิดีโอ
recordingDetails.locationDescription string
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน

ข้อความอธิบายในตำแหน่งที่มีการบันทึกวิดีโอ
recordingDetails.location object
ข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ โปรดทราบว่าค่าพร็อพเพอร์ตี้ย่อยจะระบุสถานที่ที่เจ้าของวิดีโอต้องการเชื่อมโยงกับวิดีโอ ค่านี้แก้ไขได้และค้นหาได้ในวิดีโอสาธารณะ และอาจแสดงต่อผู้ใช้ในวิดีโอสาธารณะ
recordingDetails.location.latitude double
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน

ละติจูดเป็นองศา
recordingDetails.location.longitude double
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน

ลองจิจูดเป็นองศา
recordingDetails.location.altitude double
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 9 กรกฎาคม 2018 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน

ความสูงเหนือวงรีอ้างอิงในหน่วยเมตร
recordingDetails.recordingDate datetime
วันที่และเวลาที่มีการบันทึกวิดีโอ ค่าจะระบุไว้ในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ)
fileDetails object
ออบเจ็กต์ fileDetails สรุปข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube ซึ่งรวมถึงความละเอียดของไฟล์ ระยะเวลา ตัวแปลงสัญญาณเสียงและวิดีโอ อัตราบิตของสตรีม และอื่นๆ เจ้าของวิดีโอเท่านั้นที่สามารถดึงข้อมูลนี้ได้

ระบบจะแสดงผลออบเจ็กต์ fileDetails หากพร็อพเพอร์ตี้ processingDetails.fileAvailability มีค่าเป็น available เท่านั้น
fileDetails.fileName string
ชื่อไฟล์ที่อัปโหลด ช่องนี้จะปรากฏไม่ว่าจะอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่นหรือไม่
fileDetails.fileSize unsigned long
ขนาดของไฟล์ที่อัปโหลดในหน่วยไบต์ ช่องนี้จะปรากฏไม่ว่าจะอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่นหรือไม่
fileDetails.fileType string
ประเภทของไฟล์ที่อัปโหลดซึ่งเครื่องมือประมวลผลวิดีโอของ YouTube ตรวจพบ ปัจจุบัน YouTube ประมวลผลเฉพาะไฟล์วิดีโอเท่านั้น แต่จะมีช่องนี้ไม่ว่าจะอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่นหรือไม่

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • archive – ไฟล์นี้เป็นไฟล์ที่เก็บถาวร เช่น ไฟล์เก็บถาวร .zip
  • audio – ไฟล์นี้เป็นไฟล์เสียงประเภทที่รู้จัก เช่น ไฟล์ .mp3
  • document – ไฟล์คือเอกสารหรือไฟล์ข้อความ เช่น เอกสาร MS Word
  • image – ไฟล์เป็นไฟล์ภาพ เช่น รูปภาพ .jpeg
  • other – ไฟล์นี้เป็นประเภทไฟล์ที่ไม่ใช่วิดีโอ
  • project – ไฟล์นี้เป็นไฟล์โครงการวิดีโอ เช่น โครงการ Microsoft Windows Movie Maker ซึ่งไม่มีข้อมูลวิดีโอจริง
  • video – ไฟล์เป็นประเภทไฟล์วิดีโอที่รู้จัก เช่น ไฟล์ .mp4
fileDetails.container string
รูปแบบคอนเทนเนอร์ของไฟล์วิดีโอที่อัปโหลด
fileDetails.videoStreams[] list
รายการสตรีมวิดีโอที่อยู่ในไฟล์วิดีโอที่อัปโหลด แต่ละรายการในลิสต์จะมีข้อมูลเมตาโดยละเอียดเกี่ยวกับสตรีมวิดีโอ
fileDetails.videoStreams[].widthPixels unsigned integer
ความกว้างของเนื้อหาวิดีโอที่เข้ารหัสเป็นพิกเซล คุณคำนวณอัตราส่วนการเข้ารหัสของวิดีโอเป็น width_pixels / height_pixels ได้
fileDetails.videoStreams[].heightPixels unsigned integer
ความสูงของเนื้อหาวิดีโอที่เข้ารหัสในหน่วยพิกเซล
fileDetails.videoStreams[].frameRateFps double
อัตราเฟรมของสตรีมวิดีโอเป็นเฟรมต่อวินาที
fileDetails.videoStreams[].aspectRatio double
สัดส่วนภาพในการแสดงผลของเนื้อหาวิดีโอ ซึ่งจะระบุสัดส่วนการแสดงผลวิดีโอ
fileDetails.videoStreams[].codec string
ตัวแปลงรหัสวิดีโอที่สตรีมใช้
fileDetails.videoStreams[].bitrateBps unsigned long
อัตราบิตของสตรีมวิดีโอเป็นบิตต่อวินาที
fileDetails.videoStreams[].rotation string
จำนวนเงินที่ YouTube ต้องใช้ในการหมุนเวียนเนื้อหาต้นฉบับเพื่อให้แสดงวิดีโอได้อย่างเหมาะสม

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • clockwise – วิดีโอต้องหมุน 90 องศาตามเข็มนาฬิกา
  • counterClockwise – วิดีโอต้องหมุน 90 องศาทวนเข็มนาฬิกา
  • none – วิดีโอไม่จำเป็นต้องหมุน
  • other – วิดีโอจำเป็นต้องหมุนด้วยวิธีอื่นที่ไม่มีความสำคัญ
  • upsideDown – วิดีโอต้องหมุนกลับหัว
fileDetails.videoStreams[].vendor string
ค่าที่ระบุผู้ให้บริการวิดีโอได้โดยไม่ซ้ำกัน โดยปกติแล้ว ค่านี้จะเป็นรหัสผู้ให้บริการแบบ 4 ตัวอักษร
fileDetails.audioStreams[] list
รายการสตรีมเสียงที่อยู่ในไฟล์วิดีโอที่อัปโหลด แต่ละรายการในลิสต์จะมีข้อมูลเมตาโดยละเอียดเกี่ยวกับสตรีมเสียง
fileDetails.audioStreams[].channelCount unsigned integer
จำนวนช่องเสียงในสตรีม
fileDetails.audioStreams[].codec string
ตัวแปลงสัญญาณเสียงที่สตรีมใช้
fileDetails.audioStreams[].bitrateBps unsigned long
อัตราบิตของสตรีมเสียงเป็นบิตต่อวินาที
fileDetails.audioStreams[].vendor string
ค่าที่ระบุผู้ให้บริการวิดีโอได้โดยไม่ซ้ำกัน โดยปกติแล้ว ค่านี้จะเป็นรหัสผู้ให้บริการแบบ 4 ตัวอักษร
fileDetails.durationMs unsigned long
ความยาวของวิดีโอที่อัปโหลดเป็นมิลลิวินาที
fileDetails.bitrateBps unsigned long
อัตราบิตรวม (วิดีโอและเสียง) ของไฟล์วิดีโอที่อัปโหลดเป็นบิตต่อวินาที
fileDetails.creationTime string
วันที่และเวลาที่สร้างไฟล์วิดีโอที่อัปโหลด ค่าจะระบุไว้ในรูปแบบ ISO 8601 ในปัจจุบัน ระบบสนับสนุนรูปแบบ ISO 8601 ดังต่อไปนี้:
  • วันที่เท่านั้น: YYYY-MM-DD
  • เวลาเริ่มต้น: YYYY-MM-DDTHH:MM:SS
  • เวลาพร้อมเขตเวลา: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
ออบเจ็กต์ processingDetails สรุปข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ในออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและระยะเวลาโดยประมาณที่เหลืออยู่จนกว่า YouTube จะประมวลผลวิดีโอเสร็จสิ้น ส่วนนี้ยังระบุว่าวิดีโอมีข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพขนาดย่อ หรือไม่

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • failed – การประมวลผลวิดีโอล้มเหลว ดู ProcessingFailureReason
  • processing – กำลังประมวลผลวิดีโอ ดูกำลังประมวลผลความคืบหน้า
  • succeeded – ประมวลผลวิดีโอเรียบร้อยแล้ว
  • terminated – ไม่มีข้อมูลการประมวลผลอีกต่อไป
processingDetails.processingProgress object
ออบเจ็กต์ processingProgress มีข้อมูลเกี่ยวกับความคืบหน้าที่ YouTube ดำเนินการประมวลผลวิดีโอ ค่าจะมีความเกี่ยวข้องก็ต่อเมื่อสถานะการประมวลผลของวิดีโอคือ processing
processingDetails.processingProgress.partsTotal unsigned long
จำนวนส่วนทั้งหมดโดยประมาณที่ต้องประมวลผลสำหรับวิดีโอ ตัวเลขนี้อาจได้รับการอัปเดตด้วยค่าประมาณที่แม่นยำยิ่งขึ้นในขณะที่ YouTube ประมวลผลวิดีโอ
processingDetails.processingProgress.partsProcessed unsigned long
จำนวนส่วนต่างๆ ของวิดีโอที่ YouTube ประมวลผลแล้ว คุณจะประมาณเปอร์เซ็นต์ของวิดีโอที่ YouTube ประมวลผลแล้วได้โดยการคำนวณดังนี้
100 * parts_processed / parts_total

โปรดทราบว่าเนื่องจากจำนวนส่วนโดยประมาณอาจเพิ่มขึ้นได้โดยที่จำนวนส่วนที่ประมวลผลไปแล้วไม่เพิ่มขึ้น จึงอาจเป็นไปได้ที่ความคืบหน้าที่คำนวณแล้วอาจลดลงเป็นระยะๆ ขณะที่ YouTube ประมวลผลวิดีโอ
processingDetails.processingProgress.timeLeftMs unsigned long
ระยะเวลาโดยประมาณในหน่วยมิลลิวินาทีที่ YouTube ต้องใช้ในการประมวลผลวิดีโอให้เสร็จสิ้น
processingDetails.processingFailureReason string
สาเหตุที่ YouTube ประมวลผลวิดีโอไม่สำเร็จ พร็อพเพอร์ตี้นี้จะมีค่าก็ต่อเมื่อค่าของพร็อพเพอร์ตี้ processingStatus คือ failed

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • other – คอมโพเนนต์การประมวลผลอื่นล้มเหลว
  • streamingFailed – ส่งวิดีโอไปยังสตรีมเมอร์ไม่ได้
  • transcodeFailed – แปลงเนื้อหาไม่สำเร็จ
  • uploadFailed – ส่งไฟล์ไม่สำเร็จ
processingDetails.fileDetailsAvailability string
ค่านี้ระบุว่ารายละเอียดของไฟล์พร้อมใช้งานสำหรับวิดีโอที่อัปโหลดหรือไม่ คุณเรียกดูรายละเอียดไฟล์ของวิดีโอได้โดยขอส่วน fileDetails ในคำขอ videos.list()
processingDetails.processingIssuesAvailability string
ค่านี้ระบุว่าเครื่องมือประมวลผลวิดีโอได้สร้างคำแนะนำที่อาจปรับปรุงความสามารถของ YouTube ในการประมวลผลวิดีโอ คำเตือนที่อธิบายปัญหาการประมวลผลวิดีโอ หรือข้อผิดพลาดที่ทำให้เกิดปัญหาในการประมวลผลวิดีโอหรือไม่ คุณดึงข้อมูลคำแนะนำเหล่านี้ได้โดยขอส่วน suggestions ในคำขอ videos.list()
processingDetails.tagSuggestionsAvailability string
ค่านี้บ่งบอกว่ามีคำแนะนำคีย์เวิร์ด (แท็ก) สำหรับวิดีโอหรือไม่ คุณสามารถเพิ่มแท็กในข้อมูลเมตาของวิดีโอเพื่อให้ผู้ใช้คนอื่นค้นหาวิดีโอได้ง่ายขึ้น คุณดึงข้อมูลคำแนะนำเหล่านี้ได้โดยขอส่วน suggestions ในคำขอ videos.list()
processingDetails.editorSuggestionsAvailability string
ค่านี้ระบุว่าวิดีโอมีคำแนะนำในการตัดต่อวิดีโอซึ่งอาจปรับปรุงคุณภาพหรือประสบการณ์การเล่นของวิดีโอหรือไม่ คุณดึงข้อมูลคำแนะนำเหล่านี้ได้โดยขอส่วน suggestions ในคำขอ videos.list()
processingDetails.thumbnailsAvailability string
ค่านี้ระบุว่ามีการสร้างภาพขนาดย่อสำหรับวิดีโอหรือไม่
suggestions object
ออบเจ็กต์ suggestions สรุปคำแนะนำที่ระบุโอกาสในการปรับปรุงคุณภาพหรือข้อมูลเมตาของวิดีโอที่อัปโหลด เจ้าของวิดีโอเท่านั้นที่สามารถดึงข้อมูลนี้ได้

ระบบจะแสดงผลออบเจ็กต์ suggestions ก็ต่อเมื่อพร็อพเพอร์ตี้ processingDetails.tagSuggestionsAvailability หรือพร็อพเพอร์ตี้ processingDetails.editorSuggestionsAvailability มีค่าเป็น available
suggestions.processingErrors[] list
รายการข้อผิดพลาดที่จะทำให้ YouTube ประมวลผลวิดีโอที่อัปโหลดไม่สำเร็จ ข้อผิดพลาดเหล่านี้บ่งบอกว่าไม่ว่าสถานะการประมวลผลปัจจุบันของวิดีโอจะเป็นอย่างไร แต่ท้ายที่สุดแล้ว สถานะนั้นจะเป็น failed อย่างแน่นอน

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • archiveFile – ไฟล์ที่เก็บถาวร (เช่น ไฟล์เก็บถาวร ZIP)
  • audioFile – ไฟล์มีเฉพาะเสียง (เช่น ไฟล์ MP3)
  • docFile – ไฟล์เอกสารหรือไฟล์ข้อความ (เช่น เอกสาร MS Word)
  • imageFile – ไฟล์ภาพ (เช่น รูปภาพ JPEG)
  • notAVideoFile – ไฟล์อื่นๆ ที่ไม่ใช่วิดีโอ
  • projectFile – ไฟล์โปรเจ็กต์ภาพยนตร์ (เช่น โปรเจ็กต์ Microsoft Windows Movie Maker)
suggestions.processingWarnings[] list
รายการสาเหตุที่ YouTube อาจพบปัญหาในการแปลงวิดีโอที่อัปโหลด หรืออาจส่งผลให้การแปลงผิดพลาด ซึ่งระบบจะสร้างคำเตือนเหล่านี้ขึ้นก่อนที่ YouTube จะประมวลผลไฟล์วิดีโอที่อัปโหลดจริง นอกจากนี้ เครื่องมือดังกล่าวยังระบุปัญหาที่ไม่ได้ระบุว่าการประมวลผลวิดีโอจะล้มเหลวเสมอไป แต่อาจทำให้เกิดปัญหา เช่น ปัญหาการซิงค์ อาร์ติแฟกต์วิดีโอ หรือแทร็กเสียงขาดหายไป

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • hasEditlist – ขณะนี้ยังไม่รองรับการแก้ไขรายการ
  • inconsistentResolution - ความละเอียดของคอนเทนเนอร์และสตรีมที่ขัดแย้งกัน
  • problematicAudioCodec – มีการใช้ตัวแปลงสัญญาณเสียงที่ทราบแล้วว่าทำให้เกิดปัญหา
  • problematicVideoCodec – มีการใช้ตัวแปลงรหัสวิดีโอที่ทราบว่าทำให้เกิดปัญหา
  • unknownAudioCodec – ตัวแปลงสัญญาณเสียงที่ไม่รู้จัก อาจแปลงรหัสไม่สำเร็จ
  • unknownContainer – รูปแบบไฟล์ที่ไม่รู้จัก การแปลงอาจล้มเหลว
  • unknownVideoCodec – ตัวแปลงรหัสวิดีโอที่ไม่รู้จัก การแปลงอาจล้มเหลว
suggestions.processingHints[] list
รายการคำแนะนำที่อาจปรับปรุงความสามารถของ YouTube ในการประมวลผลวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • nonStreamableMov – ไฟล์ MP4 ไม่สามารถสตรีมได้ ซึ่งจะทำให้การประมวลผลช้าลง
  • sendBestQualityVideo – วิดีโอน่าจะมีคุณภาพดีกว่า
suggestions.tagSuggestions[] list
รายการแท็กคีย์เวิร์ดที่เพิ่มลงในข้อมูลเมตาของวิดีโอได้เพื่อเพิ่มโอกาสที่ผู้ใช้จะค้นหาวิดีโอของคุณเมื่อค้นหาหรือท่องเว็บใน YouTube
suggestions.tagSuggestions[].tag string
แท็กคีย์เวิร์ดที่แนะนำสำหรับวิดีโอ
suggestions.tagSuggestions[].categoryRestricts[] list
ชุดหมวดหมู่วิดีโอที่เกี่ยวข้องกับแท็ก คุณสามารถใช้ข้อมูลนี้เพื่อแสดงคำแนะนำแท็กที่เหมาะสมตามหมวดหมู่วิดีโอที่ผู้อัปโหลดวิดีโอเชื่อมโยงกับวิดีโอ โดยค่าเริ่มต้น คำแนะนำแท็กจะมีความเกี่ยวข้องกับทุกหมวดหมู่ หากไม่มีการกำหนดข้อจำกัดสำหรับคีย์เวิร์ดนั้น
suggestions.editorSuggestions[] list
รายการการดำเนินการตัดต่อวิดีโอที่อาจปรับปรุงคุณภาพวิดีโอหรือประสบการณ์การเล่นของวิดีโอที่อัปโหลด

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • audioQuietAudioSwap – แทร็กเสียงจะเงียบลงและอาจนำไปสลับกับเสียงที่มีคุณภาพสูงกว่าได้
  • videoAutoLevels - ระดับความสว่างของภาพปิดอยู่และสามารถแก้ไขได้
  • videoCrop – ระบบอาจครอบตัดระยะขอบ (ด้าน) รอบรูปภาพ
  • videoStabilize – วิดีโอสั่นไหวและใช้กันภาพสั่นได้
liveStreamingDetails object
ออบเจ็กต์ liveStreamingDetails มีข้อมูลเมตาเกี่ยวกับการถ่ายทอดสดวิดีโอ วัตถุจะแสดงในทรัพยากร video เท่านั้นหากวิดีโอกำลังถ่ายทอดสด กำลังถ่ายทอดสด หรือการถ่ายทอดสดที่จบไปแล้ว
liveStreamingDetails.actualStartTime datetime
เวลาที่ออกอากาศจริง ค่าจะระบุไว้ในรูปแบบ ISO 8601 ค่านี้จะไม่พร้อมให้ใช้งานจนกว่าการออกอากาศจะเริ่ม
liveStreamingDetails.actualEndTime datetime
เวลาที่การออกอากาศสิ้นสุดลงจริง ค่าจะระบุไว้ในรูปแบบ ISO 8601 ค่านี้จะใช้ไม่ได้จนกว่าการออกอากาศสิ้นสุด
liveStreamingDetails.scheduledStartTime datetime
เวลาที่กำหนดให้เริ่มออกอากาศ ค่าจะระบุไว้ในรูปแบบ ISO 8601
liveStreamingDetails.scheduledEndTime datetime
เวลาที่กำหนดให้การออกอากาศสิ้นสุดลง ค่าจะระบุไว้ในรูปแบบ ISO 8601 หากค่าว่างเปล่าหรือไม่มีพร็อพเพอร์ตี้อยู่ กำหนดเวลาออกอากาศจะดำเนินต่อไปโดยไม่มีกำหนด
liveStreamingDetails.concurrentViewers unsigned long
จำนวนผู้ชมที่กำลังรับชมการออกอากาศ พร็อพเพอร์ตี้และค่าของพร็อพเพอร์ตี้จะแสดงหากการออกอากาศมีผู้ชมปัจจุบัน และเจ้าของการออกอากาศไม่ได้ซ่อนจำนวนการดูของวิดีโอ โปรดทราบว่า YouTube จะหยุดติดตามจำนวนผู้ชมในเวลาเดียวกันสำหรับการออกอากาศเมื่อการออกอากาศสิ้นสุดลง ดังนั้น พร็อพเพอร์ตี้นี้จะระบุจำนวนผู้ชมที่ดูวิดีโอที่เก็บถาวรของการถ่ายทอดสดที่จบไปแล้ว
จํานวนผู้ชมพร้อมกันที่ YouTube Data API แสดงผลอาจแตกต่างจากจํานวนผู้ชมพร้อมกันที่ประมวลผลแล้วและมีการลดสแปมที่มีอยู่ผ่าน YouTube Analytics ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสดได้ในศูนย์ช่วยเหลือของ YouTube
liveStreamingDetails.activeLiveChatId string
รหัสของแชทสดที่ใช้งานอยู่ในปัจจุบันซึ่งแนบมากับวิดีโอนี้ ระบบจะกรอกข้อมูลในช่องนี้เมื่อวิดีโอเป็นการถ่ายทอดสดที่กำลังออกอากาศและมีแชทสดเท่านั้น เมื่อเปลี่ยนการออกอากาศเพื่อกรอกข้อมูลในช่องนี้แล้ว ระบบจะนำแชทสดออกและแชทสดจะปิดลง สำหรับการออกอากาศอย่างต่อเนื่อง รหัสแชทสดจะไม่เชื่อมโยงกับวิดีโอนี้อีกต่อไป แต่เชื่อมโยงกับวิดีโอใหม่ที่แสดงในหน้าถาวร
localizations object
ออบเจ็กต์ localizations มีคำแปลข้อมูลเมตาของวิดีโอ
localizations.(key) object
ภาษาของข้อความที่แปลแล้วที่เชื่อมโยงกับคีย์-ค่า ค่าเป็นสตริงที่มีรหัสภาษา BCP-47
localizations.(key).title string
ชื่อวิดีโอที่แปล
localizations.(key).description string
คำอธิบายวิดีโอที่แปลแล้ว