Videos

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

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

เมธอด

API รองรับวิธีการต่อไปนี้สําหรับทรัพยากร videos

getRating
ดึงข้อมูลการให้คะแนนที่ผู้ใช้ที่ได้รับอนุญาตมอบให้กับรายการวิดีโอที่ระบุ ลองใช้เลย
list
แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
แทรก
อัปโหลดวิดีโอไปยัง YouTube และตั้งค่าข้อมูลเมตาของวิดีโอ (ไม่บังคับ)
update
อัปเดตข้อมูลเมตาของวิดีโอ ลองใช้เลย
ลบ
ลบวิดีโอ 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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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 – ภาพขนาดย่อเริ่มต้น ภาพปกเริ่มต้นของวิดีโอหรือแหล่งข้อมูลที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา จะมีความกว้าง 120 พิกเซลและความสูง 90 พิกเซล ภาพปกเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงขึ้น สำหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 320 พิกเซลและความสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้ควรมีความกว้าง 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
ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่/ใช้งานอยู่หรือไม่ หรือเป็น "none" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กําลังจะมีขึ้น/กำลังถ่ายทอดสด

ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้คือ
  • 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 – E
  • acbG – G
  • acbM – M
  • 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 – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
การจัดประเภท Anatel (Asociación Nacional de Televisión) ของวิดีโอสำหรับโทรทัศน์ชิลี

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
การจัดประเภทของคณะกรรมการจัดประเภทภาพยนตร์ของสหราชอาณาจักร (BBFC) สำหรับวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • bbfc12 – 12
  • bbfc12a – 12 แอมป์
  • 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 – E
  • bfvcG – G
  • 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 TV - Canadian TV Classification System การจัดประเภทวิดีโอจากคณะกรรมการวิทยุและโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศภาษาอังกฤษของแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • catv14plus – 14 ปีขึ้นไป
  • catv18plus – 18 ปีขึ้นไป
  • catvC – C
  • catvC8 - C8
  • catvG – G
  • 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
การจัดประเภทของคณะกรรมการกลางพิจารณาภาพยนตร์ (CBFC - อินเดีย) สำหรับวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • 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 excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
การจัดประเภทของวิดีโอจาก Comissão de Classificação de Espect´culos ของโปรตุเกส

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • 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 – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
การจัดประเภทวิดีโอจาก Commission de Contrôle des Films (เบลเยียม)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • cicfE – E
  • 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 classification cinematographique

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 - 18 ปี
  • cncE – E
  • cncT – T
  • 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 classification des films (CSCF) ของลักเซมเบิร์ก

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 - 18 ปี
  • cscf6-6
  • cscf9-9
  • cscfA – A
  • cscfAl – AL
  • 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 - บราซิล) ของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • 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 – 15 แอมป์
  • ecbmct15plus – 15 ปีขึ้นไป
  • ecbmct18plus – 18 ปีขึ้นไป
  • ecbmct7a – 7A
  • ecbmct7plus – 7 ปีขึ้นไป
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a - 6 ก.
  • 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 – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15 ขึ้นไป
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์ของมาเลเซีย

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

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

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

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 - 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • 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 - สเปน) ของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • 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 – G
  • 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 - อาร์เจนตินา) สำหรับวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores 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
การจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของ Kenya

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • 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 – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
การจัดประเภทของคณะกรรมการการจัดประเภทสื่อเกาหลี (영상물등급위원회) สำหรับวิดีโอ KMRB จัดประเภทวิดีโอในเกาหลีใต้

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
การจัดประเภทวิดีโอจากภาพยนตร์เซ็นเซอร์ Lembaga ของอินโดนีเซีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – วัน
  • 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) จากสภาสื่อสำหรับเด็กและเยาวชน

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • mccyp11 - 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • 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
การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (Media Development Authority หรือ MDA) ของสิงคโปร์ และโดยเฉพาะคณะกรรมการตรวจสอบภาพยนตร์ (Board of Film Censors หรือ BFC)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mdaG – G
  • 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 (สถาบันภาพและเสียงแห่งชาติ) ของฟินแลนด์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • meku12 - 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • 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 – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
การจัดประเภทของวิดีโอจากกระทรวงวัฒนธรรม (文化部) ของไต้หวัน

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

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

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • mtrcbG – G
  • 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 – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
การจัดประเภทวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย

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

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – อ้างถึง
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
การจัดประเภทวิดีโอจาก Nacionãlais Kino centrs (ศูนย์ภาพยนตร์แห่งชาติของลัตเวีย)

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • oflcG – G
  • 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 – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
การจัดประเภทวิดีโอในเวเนซุเอลา

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

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

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

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • skfilmG – G
  • 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 (คณะกรรมการสื่อแห่งชาติของสวีเดน)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • 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 – TV-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 เท่านั้น
status.containsSyntheticMedia boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องเปิดเผยได้ว่าวิดีโอมีเนื้อหาที่ดัดแปลงหรือสังเคราะห์ (A/S) ซึ่งดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับนโยบายของ YouTube ที่เกี่ยวข้องกับเนื้อหาการซ่อมและบำรุงรักษา

ตัวอย่างของเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้
  • ทำให้ดูเหมือนบุคคลที่มีตัวตนจริงพูดหรือกระทำบางอย่างที่บุคคลดังกล่าวไม่ได้พูดหรือกระทำจริง
  • ดัดแปลงฟุตเทจที่แสดงเหตุการณ์หรือสถานที่จริง
  • สร้างฉากที่ดูสมจริงซึ่งไม่ได้เกิดขึ้นจริง
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
จำนวนความคิดเห็นของวิดีโอ
paidProductPlacementDetails object
ออบเจ็กต์ paidProductPlacementDetails มีข้อมูลเกี่ยวกับการแสดงผลิตภัณฑ์แบบชำระเงินในวิดีโอ
paidProductPlacementDetails.hasPaidProductPlacement boolean
ตั้งค่าเป็น true หากเนื้อหาใช้การแสดงผลิตภัณฑ์แบบชำระเงิน ค่าเริ่มต้นคือ false
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 – กำลังประมวลผลวิดีโอ ดู ProcessingProgress
  • 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
คำอธิบายวิดีโอที่แปลแล้ว