Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Videos

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

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

เมธอด

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

getRating: ดึงข้อมูลคะแนนที่ผู้ใช้ที่ได้รับอนุญาตให้ไว้กับรายการวิดีโอที่ระบุ ลองใช้เลย
list: แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
batchGetStats: ดึงข้อมูลรายการสถิติของวิดีโอที่ตรงกับพารามิเตอร์คำขอ 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,
    "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
การจัดประเภทของคณะกรรมการจัดประเภทภาพยนตร์และวิดีโอของออสเตรเลีย (ACB) หรือสำนักงานกำกับดูแลสื่อสารและสื่อของออสเตรเลีย (ACMA) สำหรับวิดีโอ การจัดประเภทของ ACMA ใช้เพื่อจัดประเภทรายการโทรทัศน์สำหรับเด็ก

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

acbC – รายการที่ได้รับการจัดประเภท C จากสำนักงานกำกับดูแลด้านการสื่อสารและสื่อของออสเตรเลีย รายการเหล่านี้มีไว้สำหรับเด็ก (ที่ไม่ใช่วัยก่อนเข้าเรียน) ที่มีอายุไม่เกิน 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 – ฉัน
anatelI10 – I-10
anatelI12 – I-12
anatelI7 – I-7
anatelR - R
anatelUnrated

contentDetails.contentRating.bbfcRating

string
การจัดประเภทของ British Board of Film Classification (BBFC) สำหรับวิดีโอ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

bbfc12 – 12
bbfc12a – 12A
bbfc15 – 15
bbfc18 – 18
bbfcPg - PG
bbfcR18 – R18
bbfcU - U
bbfcUnrated

contentDetails.contentRating.bfvcRating

string
การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์และวิดีโอของไทย

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

bfvc13 – 13
bfvc15 – 15
bfvc18 – 18
bfvc20 – 20
bfvcB – B
bfvcE – 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
ระบบการจัดประเภทสำหรับทีวีของแคนาดา - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการกำกับดูแลวิทยุ โทรทัศน์ และโทรคมนาคมของแคนาดา (CRTC) สำหรับการออกอากาศภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

catv14plus – 14 ปีขึ้นไป
catv18plus – 18 ปีขึ้นไป
catvC - C
catvC8 – C8
catvG - G
catvPg - PG
catvUnrated

contentDetails.contentRating.catvfrRating

string
การจัดประเภทวิดีโอจากคณะกรรมการกำกับดูแลวิทยุ โทรทัศน์ และโทรคมนาคมของแคนาดา (CRTC) สำหรับการออกอากาศภาษาฝรั่งเศสในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของสภามาตรฐานการออกอากาศของแคนาดา

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้

catvfr13plus – 13 ปีขึ้นไป
catvfr16plus - 16 ปีขึ้นไป
catvfr18plus - 18 ปีขึ้นไป
catvfr8plus – 8 ปีขึ้นไป
catvfrG - G
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
การจัดประเภทของคณะกรรมการกลางว่าด้วยการรับรองภาพยนตร์ (CBFC - อินเดีย) ของวิดีโอ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

cbfcA – A
cbfcS – S
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 – E
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 – T
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 – L
djctqUnrated

contentDetails.contentRating.djctqRatingReasons[] list
เหตุผลที่อธิบายว่าทำไมวิดีโอจึงได้รับการจัดประเภท DJCQT (บราซิล)

contentDetails.contentRating.ecbmctRating

string
ระบบการจัดประเภทในตุรกี - คณะกรรมการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยว

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

ecbmct13a - 13A
ecbmct13plus - 13 ปีขึ้นไป
ecbmct15a – 15A
ecbmct15plus - 15 ปีขึ้นไป
ecbmct18plus - 18 ปีขึ้นไป
ecbmct7a – 7A
ecbmct7plus – 7+
ecbmctG - G
ecbmctUnrated
ecbmct6a – 6A
ecbmct6plus – 6+
ecbmct10a - 10A
ecbmct10plus – 10+
ecbmct16plus - 16 ปีขึ้นไป

contentDetails.contentRating.eefilmRating

string
การจัดประเภทของวิดีโอในเอสโตเนีย

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

eefilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย
eefilmK14 – K-14
eefilmK16 - K-16
eefilmK6 - K-6
eefilmL – L
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 – ฉัน
fcoIi – II
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
การจัดประเภทของวิดีโอจาก Film and Publication Board ของแอฟริกาใต้

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้

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 – E
grfilmK - K
grfilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย
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 - Argentina) ของวิดีโอ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

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 – AL
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

string
การจัดประเภทของคณะกรรมการจัดประเภทสื่อของเกาหลี (영상물등급위원회) สำหรับวิดีโอ โดย KMRB จะจัดประเภทวิดีโอในเกาหลีใต้

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

kmrb12plus – 12세 이상 관람가
kmrb15plus – 15세 이상 관람가
kmrbAll - 전체관람가
kmrbR – 청소년 관람불가
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

string
การจัดประเภทวิดีโอจาก Lembaga Sensor Film ของอินโดนีเซีย

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

lsf13 – 13
lsf17 – 17
lsf21 – 21
lsfA – 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 – A
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 - G
moctwP – P
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 (Red Band - แนะนำสำหรับผู้ที่มีอายุ 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 – A
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 – RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
การจัดประเภทของวิดีโอจาก Nacionãlais Kino centrs (ศูนย์ภาพยนตร์แห่งชาติของลัตเวีย)

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

nkclv12plus - 12 ปีขึ้นไป
nkclv18plus - 18 ปีขึ้นไป
nkclv7plus – 7+
nkclvU - U
nkclvUnrated

contentDetails.contentRating.oflcRating

string
การจัดประเภทของสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรม (OFLC - นิวซีแลนด์) ของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้

oflcG - G
oflcM - M
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 - C
resorteviolenciaD - วัน
resorteviolenciaE – E
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

string
การจัดประเภทของวิดีโอจาก General Directorate of Radio, Television and Cinematography (เม็กซิโก)

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้

rtcA – A
rtcAa – AA
rtcB – B
rtcB15 – B15
rtcC - C
rtcD - วัน
rtcUnrated

contentDetails.contentRating.rteRating

string
การจัดประเภทของวิดีโอจาก Raidió Teilifís Éireann ของไอร์แลนด์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้

rteCh – CH
rteGa - GA
rteMa – MA
rtePs – PS
rteUnrated

contentDetails.contentRating.russiaRating

string
การจัดประเภทของ National Film Registry of the Russian Federation (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 – L
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 ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้วก็ตาม
คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็น 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

ตัวอย่างเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้

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

statistics object
ออบเจ็กต์ statistics มีสถิติเกี่ยวกับวิดีโอ

statistics.viewCount

unsigned long

จำนวนครั้งที่มีการดูวิดีโอ

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป สำหรับ Shorts ค่า viewCount จะแสดงจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีข้อกำหนดเวลาในการรับชมขั้นต่ำ

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 เริ่มแสดงรหัสหัวข้อที่คัดสรรมาแล้วจำนวนเล็กน้อย

ดูรหัสหัวข้อที่รองรับ ณ วันที่ 15 กุมภาพันธ์ 2017

หัวข้อ
หัวข้อเพลง
/m/04rlf	เพลง (หัวข้อหลัก)
/m/02mscn	เพลงคริสเตียน
/m/0ggq0m	เพลงคลาสสิก
/m/01lyv	ประเทศ
/m/02lkt	เพลงอิเล็กทรอนิกส์
/m/0glt670	เพลงฮิปฮอป
/m/05rwpb	เพลงอินดี้
/m/03_d0	แจ๊ส
/m/028sqc	เพลงเอเชีย
/m/0g293	เพลงของลาตินอเมริกา
/m/064t9	เพลงป๊อป
/m/06cqb	เร็กเก้
/m/06j6l	ริธึมแอนด์บลูส์
/m/06by7	เพลงร็อก
/m/0gywn	เพลงโซล
หัวข้อเกม
/m/0bzvm2	เกม (หัวข้อหลัก)
/m/025zzc	เกมแอ็กชัน
/m/02ntfj	เกมแอ็กชันผจญภัย
/m/0b1vjn	เกมเล่นฆ่าเวลา
/m/02hygl	วิดีโอเกมแนวดนตรี
/m/04q1x3q	วิดีโอเกมไขปริศนา
/m/01sjng	วิดีโอเกมแข่งรถ
/m/0403l3g	วิดีโอเกมแนวสวมบทบาท
/m/021bp2	วิดีโอเกมจำลองสถานการณ์
/m/022dc6	การแข่งขันกีฬา
/m/03hf_rm	วิดีโอเกมแนววางแผน
หัวข้อกีฬา
/m/06ntj	กีฬา (หัวข้อหลัก)
/m/0jm_	อเมริกันฟุตบอล
/m/018jz	เบสบอล
/m/018w8	บาสเกตบอล
/m/01cgz	ชกมวย
/m/09xp_	Cricket
/m/02vx4	ฟุตบอล
/m/037hz	กอล์ฟ
/m/03tmr	ฮอกกี้น้ำแข็ง
/m/01h7lh	ศิลปะการต่อสู้แบบผสม
/m/0410tth	มอเตอร์สปอร์ต
/m/07bs0	เทนนิส
/m/07_53	วอลเลย์บอล
หัวข้อความบันเทิง
/m/02jjt	ความบันเทิง (หัวข้อหลัก)
/m/09kqc	เรื่องขำขัน
/m/02vxn	ภาพยนตร์
/m/05qjc	ศิลปะการแสดง
/m/066wd	มวยปล้ำอาชีพ
/m/0f2f9	รายการทีวี
หัวข้อไลฟ์สไตล์
/m/019_rr	ไลฟ์สไตล์ (หัวข้อหลัก)
/m/032tl	แฟชั่น
/m/027x7n	ฟิตเนส
/m/02wbm	อาหาร
/m/03glg	งานอดิเรก
/m/068hy	สัตว์เลี้ยง
/m/041xxh	ความน่าดึงดูดใจทางกายภาพ [ความงาม]
/m/07c1v	เทคโนโลยี
/m/07bxq	การท่องเที่ยว
/m/07yv9	ยานพาหนะ
หัวข้อเกี่ยวกับสังคม
/m/098wr	สังคม (หัวข้อหลัก)
/m/09s1f	ธุรกิจ
/m/0kt51	สุขภาพ
/m/01h6rj	การทหาร
/m/05qt0	การเมือง
/m/06bvp	ศาสนา
หัวข้ออื่นๆ
/m/01k8wb	ความรู้

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
คำอธิบายวิดีโอที่แปลแล้ว

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

เมธอด

การแสดงทรัพยากร

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

Videos