หน้านี้ได้รับการแปลโดย Cloud Translation API

Videos

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

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

วิธีการ

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

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

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

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

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

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

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

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

kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#video

etag etag
Etag ของแหล่งข้อมูลนี้

id string
รหัสที่ YouTube ใช้ในการระบุวิดีโอแบบไม่ซ้ำ

snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับวิดีโอ เช่น ชื่อ คำอธิบาย และหมวดหมู่

snippet.publishedAt

datetime
วันที่และเวลาที่เผยแพร่วิดีโอ โปรดทราบว่าเวลาดังกล่าวอาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ เช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัว แล้วเปลี่ยนเป็นแบบสาธารณะในภายหลัง พร็อพเพอร์ตี้นี้จะระบุเวลาที่ทำให้วิดีโอเป็นแบบสาธารณะ

มีกรณีพิเศษ 2 กรณีดังนี้

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

ค่าจะระบุไว้ในรูปแบบ ISO 8601

snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่มีการอัปโหลดวิดีโอโดยไม่ซ้ำกัน

snippet.title string
ชื่อวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 100 อักขระ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ > คุณต้องตั้งค่าพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และกำลังอัปเดตส่วน snippet ของทรัพยากร video

snippet.description string
คำอธิบายวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 5,000 ไบต์และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >

snippet.thumbnails object
แผนที่ของภาพขนาดย่อที่เกี่ยวข้องกับวิดีโอ สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ

snippet.thumbnails.(key)

object
คีย์-ค่าที่ใช้ได้มีดังนี้

default – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นของวิดีโอหรือทรัพยากรที่อ้างอิงไปยังวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล
medium – ภาพปกเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้จะกว้าง 240 พิกเซลและสูง 240 พิกเซล
high – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 800 พิกเซลและสูง 800 พิกเซล
standard – รูปภาพขนาดย่อเวอร์ชันความละเอียดที่สูงกว่ารูปภาพความละเอียด high ภาพนี้พร้อมใช้งานสำหรับบางวิดีโอและแหล่งข้อมูลอื่นๆ ที่อ้างถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล
maxres – ภาพปกเวอร์ชันที่มีความละเอียดสูงสุด ขนาดภาพนี้ใช้ได้กับวิดีโอบางรายการและทรัพยากรอื่นๆ ที่อ้างถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 1280 พิกเซลและสูง 720 พิกเซล

snippet.thumbnails.(key).url string
URL ของรูปภาพ

snippet.thumbnails.(key).width unsigned integer
ความกว้างของรูปภาพ

snippet.thumbnails.(key).height unsigned integer
ความสูงของรูปภาพ

snippet.channelTitle string
ชื่อช่องสำหรับช่องที่เป็นเจ้าของวิดีโอ

snippet.tags[]

list
รายการแท็กคีย์เวิร์ดที่เกี่ยวข้องกับวิดีโอ แท็กอาจมีช่องว่าง ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 500 อักขระ โปรดคำนึงถึงกฎต่อไปนี้ซึ่งเกี่ยวกับวิธีคำนวณจำนวนอักขระสูงสุด:

ค่าพร็อพเพอร์ตี้คือรายการ และคอมมาคั่นระหว่างรายการต่างๆ ในรายการจะนับรวมในขีดจํากัด
หากแท็กมีการเว้นวรรค เซิร์ฟเวอร์ API จะจัดการค่าแท็กเสมือนว่ารวมอยู่ในเครื่องหมายคำพูด และเครื่องหมายคำพูดจะนับรวมในจำนวนอักขระสูงสุด ดังนั้น ตามวัตถุประสงค์ของจำนวนอักขระสูงสุด แท็ก Foo-Baz จึงมีอักขระ 7 ตัว แต่แท็ก Foo Baz ประกอบด้วยอักขระ 9 ตัว

snippet.categoryId string
หมวดหมู่วิดีโอของ YouTube ที่เชื่อมโยงกับวิดีโอ คุณต้องตั้งค่าให้กับพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และอัปเดตส่วน snippet ของทรัพยากร video

snippet.liveBroadcastContent

string
ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่หรือดำเนินอยู่ หรือเป็น "ไม่มี" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กำลังจะเผยแพร่/ที่ดำเนินอยู่

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

live
none
upcoming

snippet.defaultLanguage string
ภาษาของข้อความในพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร video

snippet.localized

object
ออบเจ็กต์ snippet.localized มีชื่อและคำอธิบายวิดีโอที่แปลแล้ว หรือชื่อเป็นภาษาเริ่มต้นสำหรับข้อมูลเมตาของวิดีโอ

ข้อความที่แปลแล้วจะส่งคืนในตัวอย่างแหล่งข้อมูล หากคำขอ videos.list ใช้พารามิเตอร์ hl เพื่อระบุภาษาที่ควรแสดงผลข้อความที่แปลแล้วและข้อความที่แปลแล้วใช้ได้ในภาษานั้น
จะแสดงข้อมูลเมตาสำหรับภาษาเริ่มต้น หากไม่ได้ระบุค่าพารามิเตอร์ hl หรือระบุค่าไว้ แต่ข้อมูลเมตาที่แปลแล้วไม่พร้อมใช้งานสำหรับภาษาที่ระบุ

พร็อพเพอร์ตี้มีค่าแบบอ่านอย่างเดียว ใช้ออบเจ็กต์ localizations เพื่อเพิ่ม อัปเดต หรือลบชื่อที่แปลแล้ว

snippet.localized.title string
ชื่อวิดีโอที่แปล

snippet.localized.description string
คำอธิบายวิดีโอที่แปลแล้ว

snippet.defaultAudioLanguage string
พร็อพเพอร์ตี้ default_audio_language ระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ

contentDetails object
ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาวิดีโอ รวมถึงความยาวของวิดีโอ และตัวบ่งชี้ว่าวิดีโอมีคำบรรยายไหม

contentDetails.duration string
ความยาวของวิดีโอ ค่าพร็อพเพอร์ตี้คือระยะเวลา ISO 8601 ตัวอย่างเช่น สำหรับวิดีโอที่มีความยาวอย่างน้อย 1 นาทีและมีความยาวน้อยกว่า 1 ชั่วโมง ระยะเวลาจะอยู่ในรูปแบบ PT#M#S ซึ่งตัวอักษร PT ระบุว่าค่านี้ระบุระยะเวลา และตัวอักษร M และ S หมายถึงความยาวเป็นนาทีและวินาที ตามลำดับ อักขระ # ที่อยู่ตามหลังตัวอักษร M และ S เป็นจำนวนเต็มที่ระบุจำนวนนาที (หรือวินาที) ของวิดีโอ ตัวอย่างเช่น ค่า PT15M33S บ่งบอกว่าวิดีโอยาว 15 นาที 33 วินาที

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

contentDetails.dimension string
ระบุว่าวิดีโอพร้อมให้รับชมในรูปแบบ 3 มิติหรือ 2 มิติ

contentDetails.definition

string
ระบุว่าวิดีโอมีความละเอียดสูง (HD) หรือมีเฉพาะความละเอียดมาตรฐาน

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

hd
sd

contentDetails.caption

string
ระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่

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

false
true

contentDetails.licensedContent boolean
ระบุว่าวิดีโอแสดงถึงเนื้อหาที่ได้รับอนุญาตหรือไม่ ซึ่งหมายความว่ามีการอัปโหลดเนื้อหาไปยังช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube แล้วอ้างสิทธิ์โดยพาร์ทเนอร์รายดังกล่าว

contentDetails.regionRestriction object
ออบเจ็กต์ regionRestriction มีข้อมูลเกี่ยวกับประเทศที่ผู้ใช้ดูวิดีโอได้ (หรือไม่รับชม) ออบเจ็กต์จะมีพร็อพเพอร์ตี้ contentDetails.regionRestriction.allowed หรือพร็อพเพอร์ตี้ contentDetails.regionRestriction.blocked

contentDetails.regionRestriction.allowed[] list
รายการรหัสภูมิภาคที่ระบุประเทศที่ผู้ใช้ดูวิดีโอได้ หากมีพร็อพเพอร์ตี้นี้อยู่และประเทศที่ไม่ได้อยู่ในค่า ระบบจะบล็อกวิดีโอไม่ให้แสดงในประเทศนั้น หากมีพร็อพเพอร์ตี้นี้และมีรายการที่ว่างเปล่า ระบบจะบล็อกวิดีโอในทุกประเทศ

contentDetails.regionRestriction.blocked[] list
รายการรหัสภูมิภาคที่ระบุประเทศที่วิดีโอถูกบล็อก หากมีพร็อพเพอร์ตี้นี้อยู่และประเทศที่ไม่ได้อยู่ในค่า แสดงว่าวิดีโอจะดูได้ในประเทศนั้น หากมีพร็อพเพอร์ตี้นี้และมีรายการที่ว่างเปล่า แสดงว่าวิดีโอดูได้ในทุกประเทศ

contentDetails.contentRating object
ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ

contentDetails.contentRating.acbRating

string
การจัดประเภทของ Australian Classification Board (ACB) หรือ Australian Communications and Media Authority (ACMA) ของวิดีโอ การจัดประเภทของ ACMA ใช้ในการแยกประเภทรายการทีวีสำหรับเด็ก

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

acbC – โปรแกรมที่จัดอยู่ในหมวดหมู่ C จากหน่วยงานด้านการสื่อสารและสื่อแห่งออสเตรเลีย (Australian Communications and Media Authority) โปรแกรมเหล่านี้เหมาะสำหรับเด็ก (ที่ไม่ใช่วัยก่อนเข้าเรียน) ที่มีอายุไม่เกิน 14 ปี
acbE - ตะวันออก
acbG - ประตู
acbM - ล้าน
acbMa15plus – MA15+
acbP – โปรแกรมที่จัดอยู่ในหมวดหมู่ P จากหน่วยงานด้านการสื่อสารและสื่อแห่งออสเตรเลีย (Australian Communications and Media Authority) โปรแกรมเหล่านี้มีไว้สำหรับเด็กก่อนวัยเรียน
acbPg – PG
acbR18plus – R18+
acbUnrated

contentDetails.contentRating.agcomRating

string
การจัดประเภทของวิดีโอจาก Autorità per le Garanzie nelle Comunicazioni (AGCOM) ของอิตาลี

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

agcomT - ตัน
agcomUnrated
agcomVm14 – VM14
agcomVm18 – VM18

contentDetails.contentRating.anatelRating

string
การจัดประเภทของ Anatel (Asociación Nacional de Televisión) ของวิดีโอสำหรับโทรทัศน์ในชิลี

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

anatelA - ก
anatelF – ศ.
anatelI – ฉัน
anatelI10 – I-10
anatelI12 – I-12
anatelI7 - I-7
anatelR - R
anatelUnrated

contentDetails.contentRating.bbfcRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

bbfc12 – 12 ปี
bbfc12a – 12A
bbfc15 – 15 คน
bbfc18 – 18 ปี
bbfcPg – PG
bbfcR18 – R18
bbfcU – U
bbfcUnrated

contentDetails.contentRating.bfvcRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

bfvc13 – 13 ปี
bfvc15 – 15 คน
bfvc18 – 18 ปี
bfvc20 – 20 คน
bfvcB – B
bfvcE - ตะวันออก
bfvcG - ประตู
bfvcUnrated

contentDetails.contentRating.bmukkRating

string
การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทสื่อของออสเตรีย (Bundesministerium für Unterricht, Kunst und Kultur)

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

bmukk10 – 10 ปีขึ้นไป
bmukk12 – 12 ปีขึ้นไป
bmukk14 – 14 ปีขึ้นไป
bmukk16 – 16 ปีขึ้นไป
bmukk6 – 6 ปีขึ้นไป
bmukk8 – 8 ปีขึ้นไป
bmukkAa – ไม่จำกัด
bmukkUnrated

contentDetails.contentRating.catvRating

string
ระบบการจัดประเภทสำหรับแคนาดาทีวี - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศเป็นภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council

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

catv14plus – 14 ปีขึ้นไป
catv18plus – 18 ปีขึ้นไป
catvC - เซลเซียส
catvC8 - C8
catvG - ประตู
catvPg – PG
catvUnrated

contentDetails.contentRating.catvfrRating

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

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

catvfr13plus – 13 ปีขึ้นไป
catvfr16plus – 16 ปีขึ้นไป
catvfr18plus – 18 ปีขึ้นไป
catvfr8plus – 8 ปีขึ้นไป
catvfrG - ประตู
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
การจัดประเภทของ Central Board of Film Certification (CBFC - India) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cbfcA - ก
cbfcS – อา.
cbfcU – U
cbfcUnrated
cbfcUA – U/A
cbfcUA7plus – U/A
cbfcUA13plus – U/A
cbfcUA16plus – U/A

contentDetails.contentRating.cccRating

string
การให้คะแนน Consejo de Calificación Cinematográfica (ชิลี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

ccc14 – 14 ปีขึ้นไป
ccc18 – 18 ปีขึ้นไป
ccc18s – 18+ - Contenido pornográfico
ccc18v – 18+ - Contenido Excel Excesivamenteที่มีความรุนแรง
ccc6 – 6+ - Inconveniente para menores de 7 años
cccTe – เอกวาดอร์ Todo
cccUnrated

contentDetails.contentRating.cceRating

string
การจัดประเภทวิดีโอจาก Comissão de Classificação de Espect imagesculos ของโปรตุเกส

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cceM12 – 12 ปี
cceM14 – 14 ปี
cceM16 – 16 ปี
cceM18 – 18 ปี
cceM4-4 คน
cceM6 – 6 คน
cceUnrated

contentDetails.contentRating.chfilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

chfilm0 - 0
chfilm12 – 12 ปี
chfilm16 – 16 ปี
chfilm18 – 18 ปี
chfilm6 – 6 คน
chfilmUnrated

contentDetails.contentRating.chvrsRating

string
การจัดประเภทของระบบการจัดประเภทโฮมวิดีโอของแคนาดา (CHVRS) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

chvrs14a – 14A
chvrs18a – 18A
chvrsE - ตะวันออก
chvrsG - ประตู
chvrsPg – PG
chvrsR - R
chvrsUnrated

contentDetails.contentRating.cicfRating

string
การจัดประเภทของวิดีโอจาก Commission de Contrôle des Films (เบลเยียม)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cicfE - ตะวันออก
cicfKntEna – KNT/ENA
cicfKtEa – KT/EA
cicfUnrated

contentDetails.contentRating.cnaRating

string
การจัดประเภทของวิดีโอจาก CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) ของโรมาเนีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cna12 – 12 ปี
cna15 – 15 คน
cna18 – 18 ปี
cna18plus – 18 ปีขึ้นไป
cnaAp – AP
cnaUnrated

contentDetails.contentRating.cncRating

string
ระบบการจัดประเภทในฝรั่งเศส - Commission de engagement Cinematographique

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cnc10 – 10 คน
cnc12 – 12 ปี
cnc16 – 16 ปี
cnc18 – 18 ปี
cncE - ตะวันออก
cncT - ตัน
cncUnrated

contentDetails.contentRating.csaRating

string
การจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศส ซึ่งจะให้คะแนนเนื้อหาที่ออกอากาศ

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

csa10 – 10 คน
csa12 – 12 ปี
csa16 – 16 ปี
csa18 – 18 ปี
csaInterdiction – ตัดช่วง
csaT - ตัน
csaUnrated

contentDetails.contentRating.cscfRating

string
การจัดประเภทของวิดีโอจาก Commission de surveillance de laคำหลัก des Films (CSCF) ของลักเซมเบิร์ก:

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

cscf12 – 12 ปี
cscf16 – 16 ปี
cscf18 – 18 ปี
cscf6 – 6 คน
cscf9 - 9 คน
cscfA - ก
cscfAl – แอละแบมา
cscfUnrated

contentDetails.contentRating.czfilmRating

string
การจัดประเภทของวิดีโอในสาธารณรัฐเช็ก

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

czfilm12 – 12 ปี
czfilm14 – 14 ปี
czfilm18 – 18 ปี
czfilmU – U
czfilmUnrated

contentDetails.contentRating.djctqRating

string
การจัดประเภทของวิดีโอ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

djctq10 – 10 คน
djctq12 – 12 ปี
djctq14 – 14 ปี
djctq16 – 16 ปี
djctq18 – 18 ปี
djctqL – ลิตร
djctqUnrated

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

contentDetails.contentRating.ecbmctRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

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

contentDetails.contentRating.eefilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

eefilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-12)
eefilmK14 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-14)
eefilmK16 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-16)
eefilmK6 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-6)
eefilmL – ลิตร
eefilmMs12 – MS-12
eefilmMs6 – MS-6
eefilmPere – Pere
eefilmUnrated

contentDetails.contentRating.egfilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

egfilm18 – 18 ปี
egfilmBn – BN
egfilmGn – GN
egfilmUnrated

contentDetails.contentRating.eirinRating

string
การจัดประเภทของ Eirin (映倫) ของวิดีโอ Eirin เป็นระบบการจัดประเภทของญี่ปุ่น

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

eirinG - ประตู
eirinPg12 – PG-12
eirinR15plus – R15+
eirinR18plus – R18+
eirinUnrated

contentDetails.contentRating.fcbmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

fcbm13 – 13 ปี
fcbm16 – 16 ปี
fcbm18 – 18 ปี
fcbm18pa – 18PA
fcbm18pl – 18PL
fcbm18sg – 18 สิงคโปร์
fcbm18sx – 18SX
fcbmP12 – P12
fcbmP13 – P13
fcbmPg13 – PG13
fcbmU – U
fcbmUnrated

contentDetails.contentRating.fcoRating

string
การจัดประเภทวิดีโอจากสำนักงานภาพยนตร์ หนังสือพิมพ์ และบทความของฮ่องกง

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

fcoI – ฉัน
fcoIi - 2
fcoIia – IIA
fcoIib – IIB
fcoIii – 3
fcoUnrated

contentDetails.contentRating.fmocRating

string
พร็อพเพอร์ตี้นี้เลิกใช้งานแล้วตั้งแต่วันที่ 2 พฤศจิกายน 2015 โปรดใช้พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating แทน

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

fmoc10 – 10 คน
fmoc12 – 12 ปี
fmoc16 – 16 ปี
fmoc18 – 18 ปี
fmocE - ตะวันออก
fmocU – U
fmocUnrated

contentDetails.contentRating.fpbRating

string
การจัดประเภทวิดีโอจากคณะกรรมการฟิล์มและสิ่งพิมพ์ของแอฟริกาใต้

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

fpb10 – 10 คน
fpb1012Pg – 10-12PG
fpb13 – 13 ปี
fpb16 – 16 ปี
fpb18 – 18 ปี
fpb79Pg – 7-9PG
fpbA - ก
fpbPg – PG
fpbUnrated
fpbX18 - X18
fpbXx – XX

contentDetails.contentRating.fpbRatingReasons[] list
เหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภทเป็น FPB (แอฟริกาใต้)

contentDetails.contentRating.fskRating

string
การจัดประเภทวิดีโอ Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - เยอรมนี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

fsk0 – FSK 0
fsk12 – FSK 12
fsk16 – FSK 16
fsk18 – FSK 18
fsk6 – FSK 6
fskUnrated

contentDetails.contentRating.grfilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

grfilmE - ตะวันออก
grfilmK - K
grfilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-12)
grfilmK13 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-13)
grfilmK15 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-15)
grfilmK17 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-17)
grfilmK18 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-18)
grfilmUnrated

contentDetails.contentRating.icaaRating

string
การให้คะแนน Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spain) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

icaa12 – 12 ปี
icaa13 – 13 ปี
icaa16 – 16 ปี
icaa18 – 18 ปี
icaa7-7 คน
icaaApta – APTA
icaaUnrated
icaaX - X

contentDetails.contentRating.ifcoRating

string
การจัดประเภทของสำนักงานการจัดประเภทภาพยนตร์ไอร์แลนด์ (IFCO - ไอร์แลนด์) ของวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO

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

ifco12 – 12 ปี
ifco12a – 12A
ifco15 – 15 คน
ifco15a – 15A
ifco16 – 16 ปี
ifco18 – 18 ปี
ifcoG - ประตู
ifcoPg – PG
ifcoUnrated

contentDetails.contentRating.ilfilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

ilfilm12 – 12 ปี
ilfilm16 – 16 ปี
ilfilm18 – 18 ปี
ilfilmAa – AA
ilfilmUnrated

contentDetails.contentRating.incaaRating

string
การจัดประเภท INCAA ของวิดีโอ (Instituto Nacional de Cine y Artes Audiovisuales - Argentina)

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

incaaAtp – ATP (Apta para todo publico)
incaaC – X (Solo apta para canores de 18 años, de exhibición Condicionada)
incaaSam13 – 13 (Solo apta para mayores de 13 años)
incaaSam16 – 16 (Solo apta para mayores de 16 años)
incaaSam18 – 18 (Solo apta para mayores de 18 años)
incaaUnrated

contentDetails.contentRating.kfcbRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

kfcb16plus – 16 ปี
kfcbG – GE
kfcbPg – PG
kfcbR – 18 ปี
kfcbUnrated

contentDetails.contentRating.kijkwijzerRating

string
voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์)

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

kijkwijzer12 – 12 ปี
kijkwijzer14 – 14 ปี
kijkwijzer16 – 16 ปี
kijkwijzer18 – 18 ปี
kijkwijzer6 – 6 คน
kijkwijzer9 - 9 คน
kijkwijzerAl – แอละแบมา
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

string
การจัดประเภทของคณะกรรมการจัดระดับความเหมาะสมเนื้อหาสื่อของเกาหลี (영알물ؼ사型號) ของวิดีโอ KMRB ให้คะแนนวิดีโอในเกาหลีใต้

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

kmrb12plus – 12세 이미 여람
kmrb15plus – 15세 이미 電람จะทำอย่างไร
kmrbAll – 電체람
kmrbR – 청소년 ค่ำ람불ของคุณจะปรากฏ
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

lsf13 – 13 ปี
lsf17 – 17 ปี
lsf21 – 21
lsfA - ก
lsfBo – โบลิเวีย
lsfD - D
lsfR - R
lsfSu – SU
lsfUnrated

contentDetails.contentRating.mccaaRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

mccaa12 – 12 ปี
mccaa12a – 12A
mccaa14 – 14 - การจัดประเภทนี้ถูกนำออกจากโครงสร้างการจัดประเภทแบบใหม่ซึ่งเริ่มใช้ในปี 2013
mccaa15 – 15 คน
mccaa16 – 16 - การจัดประเภทนี้ถูกนำออกจากโครงสร้างการจัดประเภทแบบใหม่ซึ่งเริ่มใช้ในปี 2013
mccaa18 – 18 ปี
mccaaPg – PG
mccaaU – U
mccaaUnrated

contentDetails.contentRating.mccypRating

string
การจัดประเภทวิดีโอจากสถาบันภาพยนตร์แห่งเดนมาร์ก (Det Danske Filminstitut) Media Council for Children and Young People

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

mccyp11 – 11 คน
mccyp15 – 15 คน
mccyp7-7 คน
mccypA - ก
mccypUnrated

contentDetails.contentRating.mcstRating

string
ระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

mcst0 - 0
mcst16plus – 16 ปีขึ้นไป
mcstC13 – C13
mcstC16 – C16
mcstC18 – C18
mcstP – P
mcstUnrated
mcstT13 – T13
mcstT16 – T16
mcstT18 – T18
mcstK - K

contentDetails.contentRating.mdaRating

string
การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (MDA) ของสิงคโปร์ กล่าวอย่างเจาะจงคือ คณะกรรมการกำกับภาพยนตร์ (BFC) ของสิงคโปร์

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

mdaG - ประตู
mdaM18 – M18
mdaNc16 – NC16
mdaPg – PG
mdaPg13 – PG13
mdaR21 – R21
mdaUnrated

contentDetails.contentRating.medietilsynetRating

string
การจัดประเภทของวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานสื่อของนอร์เวย์

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

medietilsynet11 – 11 คน
medietilsynet12 – 12 ปี
medietilsynet15 – 15 คน
medietilsynet18 – 18 ปี
medietilsynet6 – 6 คน
medietilsynet7-7 คน
medietilsynet9 - 9 คน
medietilsynetA - ก
medietilsynetUnrated

contentDetails.contentRating.mekuRating

string
การจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) ของฟินแลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

meku12 – 12 ปี
meku16 – 16 ปี
meku18 – 18 ปี
meku7-7 คน
mekuS – อา.
mekuUnrated

contentDetails.contentRating.mibacRating

string
การจัดประเภทวิดีโอจาก Ministero dei Beni e delle Attività Culturali e del Turismo (อิตาลี)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

mibacT
mibacUnrated
mibacVap
mibacVm6
mibacVm12
mibacVm14
mibacVm18

contentDetails.contentRating.mocRating

string
การจัดประเภทวิดีโอของรัฐ Ministerio de Cultura (โคลอมเบีย)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

moc12 – 12 ปี
moc15 – 15 คน
moc18 – 18 ปี
moc7-7 คน
mocBanned – ถูกแบน
mocE - ตะวันออก
mocT - ตัน
mocUnrated
mocX - X

contentDetails.contentRating.moctwRating

string
การจัดประเภทวิดีโอจากกระทรวงวัฒนธรรมของไต้หวัน (化部)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

moctwG - ประตู
moctwP – P
moctwPg – PG
moctwR - R
moctwR12 – R-12
moctwR15 – R-15
moctwUnrated

contentDetails.contentRating.mpaaRating

string
การจัดประเภทของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

mpaaG - ประตู
mpaaNc17 – NC-17
mpaaPg – PG
mpaaPg13 – PG-13
mpaaR - R
mpaaUnrated

contentDetails.contentRating.mpaatRating

string
การจัดประเภทตัวอย่างภาพยนตร์และการแสดงตัวอย่างภาพยนตร์ของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา

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

mpaatGb – GB (Green Band - อนุมัติสำหรับผู้ชมทั้งหมด)
mpaatRb – RB (สายสีแดง - แนะนำสำหรับอายุ 17 ปีขึ้นไป)

contentDetails.contentRating.mtrcbRating

string
การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาและจัดประเภทภาพยนตร์และโทรทัศน์ (ฟิลิปปินส์)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

mtrcbG - ประตู
mtrcbPg – PG
mtrcbR13 – R-13
mtrcbR16 – R-16
mtrcbR18 – R-18
mtrcbUnrated
mtrcbX - X

contentDetails.contentRating.nbcRating

string
การจัดประเภทวิดีโอจากสำนักงานการจัดประเภทแห่งชาติมัลดีฟส์

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

nbc12plus – 12 ปีขึ้นไป
nbc15plus – 15 ปีขึ้นไป
nbc18plus – 18 ปีขึ้นไป
nbc18plusr – 18+R
nbcG - ประตู
nbcPg – PG
nbcPu – PU
nbcUnrated

contentDetails.contentRating.nfrcRating

string
การจัดประเภทวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

nfrcA - ก
nfrcB – B
nfrcC - เซลเซียส
nfrcD - D
nfrcUnrated
nfrcX - X

contentDetails.contentRating.nfvcbRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

nfvcb12 – 12 ปี
nfvcb12a – 12A
nfvcb15 – 15 คน
nfvcb18 – 18 ปี
nfvcbG - ประตู
nfvcbPg – PG
nfvcbRe – RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
การจัดประเภทวิดีโอจาก Nacionãlais Kino centrs (National Film Centre of Latvia)

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

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

contentDetails.contentRating.oflcRating

string
การจัดประเภทของ Office of Film and Literature Classification (OFLC - นิวซีแลนด์) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

oflcG - ประตู
oflcM - ล้าน
oflcPg – PG
oflcR13 – R13
oflcR15 – R15
oflcR16 – R16
oflcR18 – R18
oflcRp13 – RP13
oflcRp16 – RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

pefilm14 – 14 ปี
pefilm18 – 18 ปี
pefilmPg – PG
pefilmPt – โปรตุเกส
pefilmUnrated

contentDetails.contentRating.resorteviolenciaRating

string
การจัดประเภทของวิดีโอในเวเนซุเอลา

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

resorteviolenciaA - ก
resorteviolenciaB – B
resorteviolenciaC - เซลเซียส
resorteviolenciaD - D
resorteviolenciaE - ตะวันออก
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

string
การจัดประเภทของคณะกรรมการทั่วไปด้านวิทยุ โทรทัศน์ และการถ่ายทำ (เม็กซิโก) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

rtcA - ก
rtcAa – AA
rtcB – B
rtcB15 – B15
rtcC - เซลเซียส
rtcD - D
rtcUnrated

contentDetails.contentRating.rteRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

rteCh – สวิตเซอร์แลนด์
rteGa – GA
rteMa – แมสซาชูเซตส์
rtePs – การตัดสินด้วยการยิงจุดโทษ
rteUnrated

contentDetails.contentRating.russiaRating

string
การจัดประเภทวิดีโอของสำนักทะเบียนภาพยนตร์แห่งชาติสหพันธรัฐรัสเซีย (MKRF - รัสเซีย) ของวิดีโอ

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

russia0 – 0+
russia12 – 12 ปีขึ้นไป
russia16 – 16 ปีขึ้นไป
russia18 – 18 ปีขึ้นไป
russia6 – 6 ปีขึ้นไป
russiaUnrated

contentDetails.contentRating.skfilmRating

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

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

skfilmG - ประตู
skfilmP2 – P2
skfilmP5 – P5
skfilmP8 – P8
skfilmUnrated

contentDetails.contentRating.smaisRating

string
การจัดประเภทของวิดีโอในไอซ์แลนด์

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

smais12 – 12 ปี
smais14 – 14 ปี
smais16 – 16 ปี
smais18 – 18 ปี
smais7-7 คน
smaisL – ลิตร
smaisUnrated

contentDetails.contentRating.smsaRating

string
การจัดประเภทวิดีโอจาก Statens medieråd (Sweden's National Media Council)

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

smsa11 – 11 คน
smsa15 – 15 คน
smsa7-7 คน
smsaA – ทุกวัย
smsaUnrated

contentDetails.contentRating.tvpgRating

string
การจัดประเภท TV Parental Guidelines (TVPG)

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

tvpgG – TV-G
tvpgMa – TV-MA
tvpgPg – TV-PG
tvpgUnrated
tvpgY – TV-Y
tvpgY7 – TV-Y7
tvpgY7Fv – TV-Y7-FV
pg14 – ทีวี-14

contentDetails.contentRating.ytRating

string
การจัดประเภทที่ YouTube ใช้เพื่อระบุเนื้อหาที่จำกัดอายุผู้ชม

ค่าที่ถูกต้องสำหรับที่พักนี้คือ

ytAgeRestricted

contentDetails.projection

string
ระบุรูปแบบการฉายภาพของวิดีโอ

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

360
rectangular

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

status object
ออบเจ็กต์ status มีข้อมูลเกี่ยวกับการอัปโหลด การประมวลผล และสถานะความเป็นส่วนตัวของวิดีโอ

status.uploadStatus

string
สถานะของวิดีโอที่อัปโหลด

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

deleted
failed
processed
rejected
uploaded

status.failureReason

string
ค่านี้จะอธิบายสาเหตุที่ทำให้อัปโหลดวิดีโอไม่สำเร็จ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าอัปโหลดไม่สำเร็จ

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

codec
conversion
emptyFile
invalidFile
tooSmall
uploadAborted

status.rejectionReason

string
ค่านี้อธิบายถึงสาเหตุที่ YouTube ปฏิเสธวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดถูกปฏิเสธ

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

claim
copyright
duplicate
inappropriate
legal
length
termsOfUse
trademark
uploaderAccountClosed
uploaderAccountSuspended

status.privacyStatus

string
สถานะความเป็นส่วนตัวของวิดีโอ

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

private
public
unlisted

status.publishAt

datetime
วันที่และเวลาที่กำหนดให้วิดีโอเผยแพร่ โดยจะตั้งค่าได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็น "ส่วนตัว" ค่าจะระบุไว้ในรูปแบบ ISO 8601 โปรดทราบอีก 2 ประเด็นต่อไปนี้เกี่ยวกับลักษณะการทำงานของคุณสมบัตินี้:

หากคุณตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.update คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้ว
หากคำขอของคุณกำหนดเวลาให้เผยแพร่วิดีโอในช่วงเวลาใดเวลาหนึ่งในอดีต ระบบจะเผยแพร่วิดีโอทันที ดังนั้น ผลของการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เป็นวันที่และเวลาในอดีตจะเหมือนกับการเปลี่ยน privacyStatus ของวิดีโอจาก private เป็น public

status.license

string
ใบอนุญาตของวิดีโอ

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

creativeCommon
youtube

status.embeddable boolean
ค่านี้ระบุว่าสามารถฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่

status.publicStatsViewable boolean
ค่านี้ระบุว่าสถิติของวิดีโอแบบขยายในหน้าดูวิดีโอเป็นข้อมูลที่เปิดเผยต่อสาธารณะหรือไม่ สถิติดังกล่าวจะสามารถดูได้โดยค่าเริ่มต้น และสถิติต่างๆ เช่น จำนวนการดูและการให้คะแนนของวิดีโอ จะยังคงปรากฏแบบสาธารณะ แม้ว่าค่าของคุณสมบัตินี้จะตั้งค่าเป็น false

status.madeForKids boolean
ค่านี้ระบุว่าวิดีโอมีการมีเด็กเป็นกลุ่มเป้าหมายหรือไม่ และมีสถานะ "สร้างมาเพื่อเด็ก" ในปัจจุบันของวิดีโอ เช่น อาจกำหนดสถานะตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube

status.selfDeclaredMadeForKids boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องกำหนดได้ว่าวิดีโอมีเด็กเป็นกลุ่มเป้าหมาย ในคำขอ videos.list ระบบจะแสดงค่าพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คำขอ API ดังกล่าวเท่านั้น

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

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

statistics.likeCount unsigned long
จำนวนผู้ใช้ที่ระบุว่าชอบวิดีโอ

statistics.dislikeCount

unsigned long

หมายเหตุ: พร็อพเพอร์ตี้ statistics.dislikeCount ได้เป็นแบบส่วนตัวเมื่อวันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะรวมอยู่ในการตอบกลับจาก API ต่อเมื่อคำขอ API ได้รับการตรวจสอบสิทธิ์โดยเจ้าของวิดีโอเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไข

จำนวนผู้ใช้ที่ระบุว่าไม่ชอบวิดีโอ

statistics.favoriteCount unsigned long
หมายเหตุ: เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว การเลิกใช้งานนี้จะมีผลตั้งแต่วันที่ 28 สิงหาคม 2015 ตอนนี้ค่าของพร็อพเพอร์ตี้จะตั้งค่าเป็น 0 เสมอ

statistics.commentCount unsigned long
จำนวนความคิดเห็นในวิดีโอ

player object
ออบเจ็กต์ player มีข้อมูลที่คุณจะใช้เล่นวิดีโอในโปรแกรมเล่นแบบฝัง

player.embedHtml

string
แท็ก <iframe> ที่ฝังโปรแกรมเล่นที่เล่นวิดีโอ

หากคำขอ API เพื่อเรียกข้อมูลทรัพยากรระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth ระบบจะปรับขนาดของโปรแกรมเล่นแบบฝังเพื่อให้เป็นไปตามข้อกำหนดของ maxHeight และ/หรือ maxWidth
หากไม่ทราบอัตราส่วนของวิดีโอ โปรแกรมเล่นแบบฝังจะมีค่าเริ่มต้นเป็นรูปแบบ 4:3

player.embedHeight long
ความสูงของโปรแกรมเล่นแบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงพร็อพเพอร์ตี้นี้เมื่อคำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอเท่านั้น

player.embedWidth long
ความกว้างของโปรแกรมเล่นแบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงพร็อพเพอร์ตี้นี้เมื่อคำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอเท่านั้น

topicDetails object
ออบเจ็กต์ topicDetails สรุปข้อมูลเกี่ยวกับหัวข้อที่เชื่อมโยงกับวิดีโอ

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

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

topicDetails.relevantTopicIds[]

list
รายการรหัสหัวข้อที่เกี่ยวข้องกับวิดีโอ

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

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

ดูรหัสหัวข้อที่รองรับตั้งแต่วันที่ 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	วิดีโอเกม RPG
/m/021bp2	วิดีโอเกมจำลองสถานการณ์
/m/022dc6	เกมกีฬา
/m/03hf_rm	วิดีโอเกมแนวยุทธศาสตร์
หัวข้อกีฬา
/m/06ntj	กีฬา (หัวข้อหลัก)
/m/0jm_	อเมริกันฟุตบอล
/m/018jz	เบสบอล
/m/018w8	บาสเกตบอล
/m/01cgz	ชกมวย
/m/09xp_	คริกเก็ต
/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 – กำลังประมวลผลวิดีโอ ดูกำลังประมวลผลความคืบหน้า
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
คำอธิบายวิดีโอที่แปลแล้ว