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

Videos

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

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

เมธอด

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

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

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

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

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

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

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

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

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

etag etag
Etag ของทรัพยากรนี้

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

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

snippet.publishedAt

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

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

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

ค่าจะอยู่ในรูปแบบ ISO 8601

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

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

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

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

snippet.thumbnails.(key)

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

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

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

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

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

snippet.channelTitle string
ชื่อช่องสำหรับช่องที่มีวิดีโอ

snippet.tags[]

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

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

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

snippet.liveBroadcastContent

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

ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้คือ

live
none
upcoming

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

snippet.localized

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

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

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

snippet.localized.title string
ชื่อวิดีโอที่แปลเป็นภาษาท้องถิ่น

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

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

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

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

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

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

contentDetails.definition

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

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

hd
sd

contentDetails.caption

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

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

false
true

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

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

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

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

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

contentDetails.contentRating.acbRating

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

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

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

contentDetails.contentRating.agcomRating

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

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

agcomT – T
agcomUnrated
agcomVm14 – VM14
agcomVm18 – VM18

contentDetails.contentRating.anatelRating

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

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

anatelA – A
anatelF – F
anatelI – I
anatelI10 – I-10
anatelI12 – I-12
anatelI7 – I-7
anatelR – R
anatelUnrated

contentDetails.contentRating.bbfcRating

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

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

bbfc12 – 12
bbfc12a – 12 แอมป์
bbfc15 – 15
bbfc18 – 18
bbfcPg – PG
bbfcR18 – R18
bbfcU – U
bbfcUnrated

contentDetails.contentRating.bfvcRating

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

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

bfvc13 – 13
bfvc15 – 15
bfvc18 – 18
bfvc20 – 20
bfvcB – B
bfvcE – E
bfvcG – G
bfvcUnrated

contentDetails.contentRating.bmukkRating

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

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

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

contentDetails.contentRating.catvRating

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

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

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

contentDetails.contentRating.catvfrRating

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

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

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

contentDetails.contentRating.cbfcRating

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

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

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

contentDetails.contentRating.cccRating

string
การจัดประเภทของ Consejo de Calificación Cinematográfica (ชิลี)

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

ccc14 – 14 ปีขึ้นไป
ccc18 – 18 ปีขึ้นไป
ccc18s – 18+ - contenido pornográfico
ccc18v – 18+ - contenido excesivamente violento
ccc6 – 6+ - Inconveniente para menores de 7 años
cccTe – Todo espectador
cccUnrated

contentDetails.contentRating.cceRating

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

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

cceM12 – 12
cceM14 – 14
cceM16 – 16
cceM18 – 18
cceM4 - 4
cceM6-6
cceUnrated

contentDetails.contentRating.chfilmRating

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

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

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

contentDetails.contentRating.chvrsRating

string
การจัดประเภทของระบบการจัดประเภทวิดีโอสำหรับใช้ในบ้านของแคนาดา (CHVRS) ของวิดีโอ

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

chvrs14a – 14A
chvrs18a – 18A
chvrsE – ตอ.
chvrsG – G
chvrsPg – PG
chvrsR – R
chvrsUnrated

contentDetails.contentRating.cicfRating

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

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

cicfE – E
cicfKntEna – KNT/ENA
cicfKtEa – KT/EA
cicfUnrated

contentDetails.contentRating.cnaRating

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

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

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

contentDetails.contentRating.cncRating

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

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

cnc10 – 10
cnc12 – 12
cnc16 – 16
cnc18 - 18 ปี
cncE – E
cncT – T
cncUnrated

contentDetails.contentRating.csaRating

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

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

csa10 – 10
csa12 - 12
csa16 - 16
csa18 – 18
csaInterdiction – การตัดบอล
csaT - พ
csaUnrated

contentDetails.contentRating.cscfRating

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

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

cscf12 – 12
cscf16 – 16
cscf18 - 18 ปี
cscf6-6
cscf9-9
cscfA – A
cscfAl – AL
cscfUnrated

contentDetails.contentRating.czfilmRating

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

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

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

contentDetails.contentRating.djctqRating

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

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

djctq10 – 10
djctq12 – 12
djctq14 – 14
djctq16 – 16
djctq18 – 18
djctqL - ลิตร
djctqUnrated

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

contentDetails.contentRating.ecbmctRating

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

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

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

contentDetails.contentRating.eefilmRating

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

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

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

contentDetails.contentRating.egfilmRating

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

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

egfilm18 – 18
egfilmBn – BN
egfilmGn – GN
egfilmUnrated

contentDetails.contentRating.eirinRating

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

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

eirinG – G
eirinPg12 – PG-12
eirinR15plus – R15 ขึ้นไป
eirinR18plus – R18+
eirinUnrated

contentDetails.contentRating.fcbmRating

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

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

fcbm13 – 13
fcbm16 – 16
fcbm18 – 18
fcbm18pa – 18PA
fcbm18pl – 18PL
fcbm18sg – 18SG
fcbm18sx - 18SX
fcbmP12 – P12
fcbmP13 – P13
fcbmPg13 – PG13
fcbmU – U
fcbmUnrated

contentDetails.contentRating.fcoRating

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

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

fcoI – I
fcoIi - 2
fcoIia – IIA
fcoIib – IIB
fcoIii – III
fcoUnrated

contentDetails.contentRating.fmocRating

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

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

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

fmoc10 - 10
fmoc12 – 12
fmoc16 - 16
fmoc18 – 18
fmocE – E
fmocU – U
fmocUnrated

contentDetails.contentRating.fpbRating

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

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

fpb10 – 10
fpb1012Pg – 10-12PG
fpb13 – 13
fpb16 - 16
fpb18 – 18
fpb79Pg – 7-9PG
fpbA – A
fpbPg – PG
fpbUnrated
fpbX18 - X18
fpbXx – XX

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

contentDetails.contentRating.fskRating

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

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

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

contentDetails.contentRating.grfilmRating

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

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

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

contentDetails.contentRating.icaaRating

string
การจัดประเภทของ Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - สเปน) ของวิดีโอ

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

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

contentDetails.contentRating.ifcoRating

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

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

ifco12 – 12
ifco12a – 12A
ifco15 – 15
ifco15a – 15A
ifco16 - 16
ifco18 - 18 ปี
ifcoG – G
ifcoPg – PG
ifcoUnrated

contentDetails.contentRating.ilfilmRating

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

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

ilfilm12 – 12
ilfilm16 - 16
ilfilm18 – 18
ilfilmAa – AA
ilfilmUnrated

contentDetails.contentRating.incaaRating

string
การจัดประเภทของ INCAA (Instituto Nacional de Cine y Artes Audiovisuales - อาร์เจนตินา) สำหรับวิดีโอ

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

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

contentDetails.contentRating.kfcbRating

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

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

kfcb16plus - 16
kfcbG – GE
kfcbPg – PG
kfcbR – 18
kfcbUnrated

contentDetails.contentRating.kijkwijzerRating

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

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

kijkwijzer12 – 12
kijkwijzer14 - 14
kijkwijzer16 - 16
kijkwijzer18 – 18
kijkwijzer6 – 6
kijkwijzer9 – 9
kijkwijzerAl – AL
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

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

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

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

contentDetails.contentRating.lsfRating

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

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

lsf13 – 13
lsf17 – 17
lsf21 – 21
lsfA – A
lsfBo – BO
lsfD – วัน
lsfR – R
lsfSu – SU
lsfUnrated

contentDetails.contentRating.mccaaRating

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

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

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

contentDetails.contentRating.mccypRating

string
การจัดประเภทวิดีโอจากสภาสื่อสำหรับเด็กและเยาวชนของเดนมาร์ก (Det Danske Filminstitut) จากสภาสื่อสำหรับเด็กและเยาวชน

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

mccyp11 - 11
mccyp15 – 15
mccyp7 – 7
mccypA – A
mccypUnrated

contentDetails.contentRating.mcstRating

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

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

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

contentDetails.contentRating.mdaRating

string
การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (Media Development Authority หรือ MDA) ของสิงคโปร์ และโดยเฉพาะคณะกรรมการตรวจสอบภาพยนตร์ (Board of Film Censors หรือ BFC)

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

mdaG – G
mdaM18 – M18
mdaNc16 – NC16
mdaPg – PG
mdaPg13 – PG13
mdaR21 – R21
mdaUnrated

contentDetails.contentRating.medietilsynetRating

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

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

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

contentDetails.contentRating.mekuRating

string
การจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (สถาบันภาพและเสียงแห่งชาติ) ของฟินแลนด์

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

meku12 - 12
meku16 – 16
meku18 – 18
meku7 – 7
mekuS – S
mekuUnrated

contentDetails.contentRating.mibacRating

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

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

mibacT
mibacUnrated
mibacVap
mibacVm6
mibacVm12
mibacVm14
mibacVm18

contentDetails.contentRating.mocRating

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

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

moc12 - 12
moc15 – 15
moc18 - 18 ปี
moc7-7
mocBanned – ถูกแบน
mocE – E
mocT – T
mocUnrated
mocX – X

contentDetails.contentRating.moctwRating

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

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

moctwG – ช
moctwP - น.
moctwPg – PG
moctwR – R
moctwR12 – R-12
moctwR15 – R-15
moctwUnrated

contentDetails.contentRating.mpaaRating

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

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

mpaaG – G
mpaaNc17 – NC-17
mpaaPg – PG
mpaaPg13 – PG-13
mpaaR – R
mpaaUnrated

contentDetails.contentRating.mpaatRating

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

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

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

contentDetails.contentRating.mtrcbRating

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

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

mtrcbG – G
mtrcbPg – PG
mtrcbR13 – R-13
mtrcbR16 – R-16
mtrcbR18 – R-18
mtrcbUnrated
mtrcbX - X

contentDetails.contentRating.nbcRating

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

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

nbc12plus – 12 ปีขึ้นไป
nbc15plus – 15 ปีขึ้นไป
nbc18plus – 18 ปีขึ้นไป
nbc18plusr – 18+R
nbcG – G
nbcPg – PG
nbcPu – PU
nbcUnrated

contentDetails.contentRating.nfrcRating

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

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

nfrcA – ก
nfrcB – B
nfrcC – C
nfrcD – วัน
nfrcUnrated
nfrcX - X

contentDetails.contentRating.nfvcbRating

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

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

nfvcb12 – 12
nfvcb12a – 12A
nfvcb15 – 15
nfvcb18 – 18
nfvcbG – G
nfvcbPg – PG
nfvcbRe – อ้างถึง
nfvcbUnrated

contentDetails.contentRating.nkclvRating

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

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

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

contentDetails.contentRating.oflcRating

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

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

oflcG – G
oflcM – ล้าน
oflcPg – PG
oflcR13 – R13
oflcR15 – R15
oflcR16 – R16
oflcR18 – R18
oflcRp13 – RP13
oflcRp16 – RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

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

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

pefilm14 – 14
pefilm18 – 18
pefilmPg – PG
pefilmPt – PT
pefilmUnrated

contentDetails.contentRating.resorteviolenciaRating

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

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

resorteviolenciaA – A
resorteviolenciaB – B
resorteviolenciaC - ค
resorteviolenciaD - ว
resorteviolenciaE – E
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

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

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

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

contentDetails.contentRating.rteRating

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

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

rteCh – สวิสเซอร์แลนด์
rteGa – GA
rteMa – MA
rtePs – PS
rteUnrated

contentDetails.contentRating.russiaRating

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

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

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

contentDetails.contentRating.skfilmRating

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

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

skfilmG – G
skfilmP2 - P2
skfilmP5 – P5
skfilmP8 – P8
skfilmUnrated

contentDetails.contentRating.smaisRating

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

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

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

contentDetails.contentRating.smsaRating

string
การจัดประเภทของวิดีโอจาก Statens medieråd (คณะกรรมการสื่อแห่งชาติของสวีเดน)

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

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

contentDetails.contentRating.tvpgRating

string
การจัดประเภท TV Parental Guidelines (TVPG) ของวิดีโอ

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

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

contentDetails.contentRating.ytRating

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

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

ytAgeRestricted

contentDetails.projection

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

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

360
rectangular

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

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

status.uploadStatus

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

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

deleted
failed
processed
rejected
uploaded

status.failureReason

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

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

codec
conversion
emptyFile
invalidFile
tooSmall
uploadAborted

status.rejectionReason

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

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

claim
copyright
duplicate
inappropriate
legal
length
termsOfUse
trademark
uploaderAccountClosed
uploaderAccountSuspended

status.privacyStatus

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

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

private
public
unlisted

status.publishAt

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

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

status.license

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

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

creativeCommon
youtube

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

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

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

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

status.containsSyntheticMedia

boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องเปิดเผยได้ว่าวิดีโอมีเนื้อหาที่ดัดแปลงหรือสังเคราะห์ (A/S) ซึ่งดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับนโยบายของ YouTube ที่เกี่ยวข้องกับเนื้อหาการซ่อมและบำรุงรักษา

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

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

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

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

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

statistics.dislikeCount

unsigned long

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

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

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

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

paidProductPlacementDetails object
ออบเจ็กต์ paidProductPlacementDetails มีข้อมูลเกี่ยวกับการแสดงผลิตภัณฑ์แบบชำระเงินในวิดีโอ

paidProductPlacementDetails.hasPaidProductPlacement boolean
ตั้งค่าเป็น true หากเนื้อหาใช้การแสดงผลิตภัณฑ์แบบชำระเงิน ค่าเริ่มต้นคือ false

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

player.embedHtml

string
แท็ก <iframe> ที่ฝังวิดีโอเพลเยอร์ซึ่งเล่นวิดีโอ

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

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

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

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

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

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

topicDetails.relevantTopicIds[]

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

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

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

ดูรหัสหัวข้อที่รองรับ ณ วันที่ 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_	คริกเก็ต
/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
คำอธิบายวิดีโอที่แปลแล้ว