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à ของอิตาลีต่อ le Garanzie nelle Comunicazioni (AGCOM)

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • anatelA - A
  • anatelF – ศ.
  • anatelI - I
  • anatelI10 - I-10
  • anatelI12 - I-12
  • anatelI7 - I-7
  • anatelR – ขวา
  • 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 TV - Canadian TV Classification System การจัดประเภทวิดีโอจากคณะกรรมการวิทยุ-โทรทัศน์และโทรคมนาคมของแคนาดา (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
การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ 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 - A
  • 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 majoro
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – เอกวาดอร์ Todo
  • 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 – 14 ก.
  • chvrs18a – 18 ก.
  • chvrsE – ตะวันออก
  • chvrsG – ช
  • chvrsPg – PG
  • chvrsR – ขวา
  • 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องค์ประกอบ 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) ของลักเซมเบิร์ก (CSCF)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • cscf12 – 12 ปี
  • cscf16 – 16
  • cscf18 – 18 ปี
  • cscf6 – 6
  • cscf9 - 9
  • cscfA - A
  • 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 – 13 ก.
  • ecbmct13plus – 13 ปีขึ้นไป
  • ecbmct15a – 15 ก.
  • ecbmct15plus – 15 ปีขึ้นไป
  • ecbmct18plus – 18 ปีขึ้นไป
  • ecbmct7a – 7 ก.
  • ecbmct7plus – 7 ปีขึ้นไป
  • ecbmctG – ช
  • ecbmctUnrated
  • ecbmct6a – 6 ก.
  • ecbmct6plus – 6 ปีขึ้นไป
  • ecbmct10a – 10 ก.
  • 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 - 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 – ตะวันออก
  • 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 - Spain)

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • ifco12 – 12 ปี
  • ifco12a – 12A
  • ifco15 – 15 ปี
  • ifco15a – 15 ก.
  • 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 - อาร์เจนตินา) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • 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
การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของเคนยา

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • 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
การจัดประเภทของ Korea Media Rating Board (영การนำส่ง물물ด้านขวาบน호) ของวิดีโอ KMRB ให้คะแนนวิดีโอในเกาหลีใต้

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • lsf13 – 13
  • lsf17 – 17 ปี
  • lsf21 – 21
  • lsfA - A
  • lsfBo – โบลิเวีย
  • lsfD - D
  • lsfR – ขวา
  • 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
การจัดประเภทวิดีโอจาก Danish Film Institutes (Det Danske Filminstitut) Media Council for Children and Young People

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • 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
การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (MDA) ของสิงคโปร์ โดยเฉพาะ Board of Film Censors (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 - A
  • 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 – ขวา
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
การจัดประเภทของสมาคมภาพยนตร์อเมริกัน (MPAA) ของวิดีโอ

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

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

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

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

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

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ
  • rteCh – สวิตเซอร์แลนด์
  • rteGa – GA
  • rteMa – MA
  • 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 สถานะความเป็นบิดามารดา (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 โปรดทราบข้อมูลเพิ่มเติมสองข้อต่อไปนี้เกี่ยวกับการทำงานของคุณสมบัตินี้:
  • หากคุณตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด 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 – กำลังประมวลผลวิดีโอ ดู 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 จะหยุดติดตามจำนวนผู้ชมที่ดูพร้อมกัน ของการออกอากาศเมื่อการออกอากาศสิ้นสุดลง ดังนั้น พร็อพเพอร์ตี้นี้จะระบุจำนวนผู้ชมที่ดูวิดีโอที่เก็บถาวรของการถ่ายทอดสดที่จบไปแล้ว
การนับจำนวนผู้ชมที่ดูพร้อมกันที่ API ข้อมูลของ YouTube แสดงผลอาจแตกต่างจากจำนวนผู้ชมที่ดูพร้อมกันที่ผ่านการประมวลผลและกำจัดสแปมแล้วที่มีให้ใน YouTube Analytics ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสดได้ในศูนย์ช่วยเหลือของ YouTube
liveStreamingDetails.activeLiveChatId string
รหัสของแชทสดที่ใช้งานอยู่ในปัจจุบันซึ่งแนบมากับวิดีโอนี้ ช่องนี้จะเติมก็ต่อเมื่อวิดีโอเป็นการถ่ายทอดสดที่กำลังเผยแพร่และมีแชทสดอยู่เท่านั้น เมื่อการออกอากาศเปลี่ยนไปยังช่องนี้เสร็จสมบูรณ์ ระบบจะนำการถ่ายทอดสดออกและแชทสดจะปิดลง สำหรับการออกอากาศอย่างต่อเนื่อง รหัสแชทสดจะไม่เชื่อมโยงกับวิดีโอนี้อีกต่อไป แต่เชื่อมโยงกับวิดีโอใหม่ที่แสดงในหน้าถาวร
localizations object
ออบเจ็กต์ localizations มีคำแปลข้อมูลเมตาของวิดีโอ
localizations.(key) object
ภาษาของข้อความที่แปลแล้วที่เชื่อมโยงกับคีย์-ค่า ค่าเป็นสตริงที่มีรหัสภาษา BCP-47
localizations.(key).title string
ชื่อวิดีโอที่แปล
localizations.(key).description string
คำอธิบายวิดีโอที่แปลแล้ว