Videos

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

เมธอด

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

getRating
ดึงข้อมูลคะแนนที่ผู้ใช้ที่ได้รับอนุญาตให้ไว้กับรายการวิดีโอที่ระบุ ลองใช้เลย
list
แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
batchGetStats
ดึงข้อมูลรายการสถิติวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
insert
อัปโหลดวิดีโอไปยัง 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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

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

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในแหล่งข้อมูลนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#video
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอโดยไม่ซ้ำกัน
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับวิดีโอ เช่น ชื่อ คำอธิบาย และหมวดหมู่
snippet.publishedAt datetime
วันที่และเวลาที่เผยแพร่วิดีโอ เวลาดังกล่าวอาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ ตัวอย่างเช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัวแล้วเปลี่ยนเป็นสาธารณะในภายหลัง พร็อพเพอร์ตี้นี้จะระบุเวลาที่วิดีโอเปลี่ยนเป็นสาธารณะ

กรณีพิเศษมีดังนี้
  • หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัวและเจ้าของช่องเรียกข้อมูลเมตาของวิดีโอ ค่าพร็อพเพอร์ตี้จะระบุวันที่และเวลาที่อัปโหลดวิดีโอ
  • หากอัปโหลดวิดีโอเป็นวิดีโอที่ไม่เป็นสาธารณะ ค่าพร็อพเพอร์ตี้จะระบุวันที่และเวลาที่อัปโหลดวิดีโอด้วย ในกรณีนี้ ทุกคนที่ทราบรหัสวิดีโอที่ไม่ซ้ำกันของวิดีโอจะดึงข้อมูลเมตาของวิดีโอได้
  • หากอัปโหลดวิดีโอเป็นวิดีโอสำหรับสมาชิกเท่านั้น ค่าพร็อพเพอร์ตี้จะระบุวันที่และเวลาที่อัปโหลดวิดีโอ
ค่าจะระบุในรูปแบบ ISO 8601
snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่อัปโหลดวิดีโอโดยไม่ซ้ำกัน ค่านี้อาจเปลี่ยนแปลงได้เมื่อเวลาผ่านไป เช่น เมื่อมีการกำหนดวิดีโอใหม่ให้กับช่องอื่น (เช่น ช่องหัวข้อหรือช่องของศิลปิน)
snippet.title string
ชื่อวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวสูงสุด 100 อักขระ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ > คุณต้องตั้งค่าสำหรับพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และกำลังอัปเดตส่วน snippet ของทรัพยากร video
snippet.description string
คำอธิบายของวิดีโอ ค่าของพร็อพเพอร์ตี้มีความยาวสูงสุด 5,000 ไบต์ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >

คุณสร้างส่วนเนื้อหาในวิดีโอได้โดยใส่การประทับเวลาที่จัดรูปแบบแล้ว (เช่น 00:00) ในข้อความคำอธิบาย
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 พิกเซล
  • fhd – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูงเต็มประสิทธิภาพ (1080p) ขนาดรูปภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 1920 พิกเซลและความสูง 1080 พิกเซล
  • qhd – รูปภาพขนาดย่อเวอร์ชัน Quad High Definition (1440p / 2K) ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 2560 พิกเซลและสูง 1440 พิกเซล
  • uhd – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูงพิเศษ (4K) ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 3840 พิกเซลและความสูง 2160 พิกเซล
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
การจัดประเภทของวิดีโอโดย British Board of Film Classification (BBFC)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
การจัดประเภทของวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์และวิดีโอของไทย

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 - 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
การจัดประเภทวิดีโอจาก Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • bmukk10 – 10+
  • bmukk12 – 12 ปีขึ้นไป
  • bmukk14 – 14 ปีขึ้นไป
  • bmukk16 – 16 ปีขึ้นไป
  • bmukk6 – 6 ปีขึ้นไป
  • bmukk8 – 8 ปีขึ้นไป
  • bmukkAa - ไม่จำกัด
  • bmukkUnrated
contentDetails.contentRating.catvRating string
ระบบการจัดประเภทสำหรับทีวีแคนาดา - ระบบการจัดประเภททีวีแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมแคนาดา (CRTC) สำหรับการออกอากาศภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • catv14plus – 14 ปีขึ้นไป
  • catv18plus - 18 ปีขึ้นไป
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (CRTC) สำหรับการออกอากาศภาษาฝรั่งเศสในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ Canadian Broadcast Standards Council

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • catvfr13plus – 13 ปีขึ้นไป
  • catvfr16plus – 16 ปีขึ้นไป
  • catvfr18plus – 18+
  • catvfr8plus – 8 ปีขึ้นไป
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
การจัดประเภทของวิดีโอโดยคณะกรรมการกลางการรับรองภาพยนตร์ (CBFC - อินเดีย)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus - U/A
contentDetails.contentRating.cccRating string
การจัดประเภท Consejo de Calificación Cinematográfica (ชิลี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • ccc14 – 14 ปีขึ้นไป
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
การจัดประเภทของวิดีโอจาก Comissão de Classificação de Espect´culos ของโปรตุเกส

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
การจัดประเภทของวิดีโอในสวิตเซอร์แลนด์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18 ปี
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
การจัดประเภทของระบบการจัดประเภทวิดีโอในบ้านของแคนาดา (CHVRS) ของวิดีโอ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
การจัดประเภทของวิดีโอจาก Commission de Contrôle des Films (เบลเยียม)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
การจัดประเภทของวิดีโอจาก CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) ของโรมาเนีย

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18 ปีขึ้นไป
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
ระบบการจัดประเภทในฝรั่งเศส - Commission de classification cinematographique

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
การจัดประเภทของวิดีโอจาก Conseil supérieur de l'audiovisuel ของฝรั่งเศส ซึ่งจัดประเภทเนื้อหาที่ออกอากาศ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction - การห้าม
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
การจัดประเภทของวิดีโอจาก Commission de surveillance de la classification des films (CSCF) ของลักเซมเบิร์ก

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
การจัดประเภทของวิดีโอในสาธารณรัฐเช็ก

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
การจัดประเภทของ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - บราซิล) สำหรับวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
เหตุผลที่อธิบายว่าทำไมวิดีโอจึงได้รับการจัดประเภท DJCQT (บราซิล)
contentDetails.contentRating.ecbmctRating string
ระบบการจัดประเภทในตุรกี - คณะกรรมการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยว

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • ecbmct13a – 13A
  • ecbmct13plus – 13 ปีขึ้นไป
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6 ปีขึ้นไป
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16 ปีขึ้นไป
contentDetails.contentRating.eefilmRating string
การจัดประเภทของวิดีโอในเอสโตเนีย

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • eefilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (K-12)
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
การจัดประเภทของวิดีโอในอียิปต์

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
การจัดประเภทของ Eirin (映倫) สำหรับวิดีโอ Eirin คือระบบการจัดประเภทของญี่ปุ่น

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus - R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
การจัดประเภทของวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์ของมาเลเซีย

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

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

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

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

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
เหตุผลที่อธิบายว่าทำไมวิดีโอจึงได้รับการจัดประเภท FPB (แอฟริกาใต้)
contentDetails.contentRating.fskRating string
การจัดประเภท Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - เยอรมนี) ของวิดีโอ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
การจัดประเภทของวิดีโอในกรีซ

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – อนุบาลถึงมัธยมศึกษาตอนปลาย (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
การจัดประเภทวิดีโอจากคณะกรรมการจัดประเภทภาพยนตร์ของเคนยา

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
การจัดประเภทของวิดีโอโดยคณะกรรมการจัดประเภทสื่อของเกาหลี (영상물등급위원회) KMRB จัดประเภทวิดีโอในเกาหลีใต้

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

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

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
ระบบการจัดประเภทวิดีโอสำหรับเวียดนาม - MCST

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mcst0 – 0
  • mcst16plus - 16 ปีขึ้นไป
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
การจัดประเภทของวิดีโอจาก Media Development Authority (MDA) ของสิงคโปร์ และโดยเฉพาะอย่างยิ่งจาก Board of Film Censors (BFC)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
การจัดประเภทวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานด้านสื่อของนอร์เวย์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
การจัดประเภทของวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (สถาบันภาพและเสียงแห่งชาติ) ของฟินแลนด์

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
การจัดประเภทวิดีโอจาก Ministero dei Beni e delle Attività Culturali e del Turismo (อิตาลี)

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
การจัดประเภทของวิดีโอโดย Ministerio de Cultura (โคลอมเบีย)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – ถูกแบน
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
การจัดประเภทของวิดีโอจากกระทรวงวัฒนธรรม (文化部) ของไต้หวัน

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

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

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

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
การจัดประเภทวิดีโอจาก Maldives National Bureau of Classification

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • nbc12plus – 12 ปีขึ้นไป
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
การจัดประเภทของวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย

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

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

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
การจัดประเภทของวิดีโอในเปรู

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
การจัดประเภทของวิดีโอในเวเนซุเอลา

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD - D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
การจัดประเภทของวิดีโอจาก General Directorate of Radio, Television and Cinematography (เม็กซิโก)

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
การจัดประเภทของวิดีโอตาม National Film Registry of the Russian Federation (MKRF - รัสเซีย)

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

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
การจัดประเภทของวิดีโอในไอซ์แลนด์

ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
การจัดประเภทของวิดีโอจาก Statens medieråd (สภาสื่อแห่งชาติของสวีเดน)

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – ทุกวัย
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
การจัดประเภทตามหลักเกณฑ์การจัดประเภทรายการทีวี (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
สถานะความเป็นส่วนตัวของวิดีโอ ในคำขอ videos.insert หากไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้นี้ สถานะความเป็นส่วนตัวของวิดีโอที่อัปโหลดจะตั้งค่าเริ่มต้นเป็น public การอัปโหลดบางรายการอาจตั้งค่าเป็นprivateโดยค่าเริ่มต้นตามการตั้งค่าบัญชีครีเอเตอร์ ดังที่อธิบายไว้ในศูนย์ช่วยเหลือของ YouTube วิดีโอที่อัปโหลดจากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันจะไม่ถูกจำกัดให้ดูในโหมดส่วนตัว

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

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

status.publicStatsViewable boolean
ค่านี้ระบุว่าสถิติแบบขยายของวิดีโอในหน้าดูวิดีโอจะแสดงต่อสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะดูได้ และสถิติ เช่น จำนวนการดูและการจัดอันดับของวิดีโอจะยังคงปรากฏต่อสาธารณะแม้ว่าจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น false ก็ตาม
status.madeForKids boolean
ค่านี้จะระบุว่าวิดีโอมีการกำหนดให้เป็นวิดีโอที่มีเด็กเป็นกลุ่มเป้าหมายหรือไม่ และมีสถานะ "สร้างมาเพื่อเด็ก" ปัจจุบันของวิดีโอ เช่น ระบบอาจกำหนดสถานะ โดยอิงตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube
status.selfDeclaredMadeForKids boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องกำหนดวิดีโอว่ามีเด็กเป็นกลุ่มเป้าหมายได้ ในคำขอ videos.list ระบบจะแสดงผลค่าพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คำขอ API เท่านั้น
status.containsSyntheticMedia boolean
ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องเปิดเผยได้ว่าวิดีโอมีเนื้อหาที่มีการดัดแปลงหรือสังเคราะห์ (A/S) ที่ดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับ YouTube นโยบายที่เกี่ยวข้องกับเนื้อหา A/S

ตัวอย่างเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้
  • ทำให้ดูเหมือนว่าบุคคลจริงพูดหรือกระทำบางอย่างซึ่งบุคคลดังกล่าวไม่ได้ทำเช่นนั้น
  • ดัดแปลงฟุตเทจที่แสดงเหตุการณ์หรือสถานที่จริง
  • สร้างฉากที่ดูสมจริงซึ่งไม่ได้เกิดขึ้นจริง
statistics object
ออบเจ็กต์ statistics มีสถิติเกี่ยวกับวิดีโอ
statistics.viewCount unsigned long

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

ตั้งแต่วันที่ 24 สิงหาคม 2569 เป็นต้นไป ระบบจะอัปเดต viewCount ให้นับยอดดูทันทีที่วิดีโอเริ่มเล่น (รวมถึงการเล่นอัตโนมัติ การวางเคอร์เซอร์เหนือวิดีโอ และการคลิก/แตะเพื่อเล่น) สำหรับวิดีโอทุกรูปแบบ (แบบยาว, ไลฟ์สด และ Shorts) ในช่อง

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

จำนวนผู้ใช้ที่ระบุว่าไม่ชอบวิดีโอ
statistics.favoriteCount unsigned long
หมายเหตุ: เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว การเลิกใช้งานมีผลตั้งแต่วันที่ 28 สิงหาคม 2015 ตอนนี้ค่าของพร็อพเพอร์ตี้จะตั้งค่าเป็น 0 เสมอ
statistics.commentCount unsigned long
จำนวนความคิดเห็นสำหรับวิดีโอ
paidProductPlacementDetails object
ออบเจ็กต์ paidProductPlacementDetails มีข้อมูลเกี่ยวกับการแสดงสินค้าแบบชำระเงินในวิดีโอ
paidProductPlacementDetails.hasPaidProductPlacement boolean
ตั้งค่าเป็น true หากเนื้อหาใช้การแสดงสินค้าแบบชำระเงิน ค่าเริ่มต้นคือ false
player object
ออบเจ็กต์ player มีข้อมูลที่คุณจะใช้เพื่อเล่นวิดีโอในโปรแกรมเล่นแบบฝัง
player.embedHtml string
แท็ก <iframe> ที่ฝังเพลเยอร์ที่เล่นวิดีโอ
  • หากคำขอ API เพื่อดึงข้อมูลทรัพยากรระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth ขนาดของเพลเยอร์แบบฝังจะปรับขนาดให้เป็นไปตามข้อกำหนด maxHeight และ/หรือ maxWidth
  • หากไม่ทราบสัดส่วนภาพของวิดีโอ โปรแกรมเล่นแบบฝังจะใช้รูปแบบ 4:3 เป็นค่าเริ่มต้น
player.embedHeight long
ความสูงของเพลเยอร์แบบฝังที่แสดงในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงผลพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่คำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอ
player.embedWidth long
ความกว้างของเพลเยอร์แบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงผลพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่คำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอ
topicDetails object
ออบเจ็กต์ topicDetails จะสรุปข้อมูลเกี่ยวกับหัวข้อที่เชื่อมโยงกับวิดีโอ

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

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

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

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 ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกไลฟ์สดได้ในศูนย์ช่วยเหลือของ YouTube
liveStreamingDetails.activeLiveChatId string
รหัสของแชทสดที่ใช้งานอยู่ในปัจจุบันซึ่งแนบมากับวิดีโอนี้ ระบบจะกรอกข้อมูลในช่องนี้ก็ต่อเมื่อวิดีโอเป็นการถ่ายทอดสดที่กำลังดำเนินอยู่ซึ่งมีแชทสด เมื่อการออกอากาศเปลี่ยนสถานะเป็นเสร็จสมบูรณ์ ระบบจะนำช่องนี้ออกและปิดแชทสด สำหรับการออกอากาศแบบถาวร รหัสแชทสดจะไม่เชื่อมโยงกับวิดีโอนี้อีกต่อไป แต่จะเชื่อมโยงกับวิดีโอใหม่ที่แสดงในหน้าถาวรแทน
brandPartner object
ออบเจ็กต์ brandPartner มีรายละเอียดเกี่ยวกับพาร์ทเนอร์แบรนด์ที่ลิงก์กับวิดีโอสำหรับสิทธิ์เข้าถึงของพาร์ทเนอร์แบรนด์ที่ครีเอเตอร์เป็นผู้เริ่ม (CI BPA)
brandPartner.channelId string
รหัสช่องภายนอกของพาร์ทเนอร์แบรนด์ ฟิลด์นี้ต้องขึ้นต้นด้วย "UC" ต้องตั้งค่า channelId หรือ channelHandle เมื่อสร้างสิทธิ์เข้าถึง แต่จะแสดงเฉพาะ channelId ในการตอบกลับ
brandPartner.channelHandle string
แฮนเดิลของช่องพาร์ทเนอร์แบรนด์ ฟิลด์นี้ต้องขึ้นต้นด้วย "@" คุณต้องตั้งค่า channelId หรือ channelHandle เมื่อสร้างการเข้าถึง แต่ระบบจะแสดงเฉพาะ channelId ในการตอบกลับ
localizations object
ออบเจ็กต์ localizations มีคำแปลของข้อมูลเมตาของวิดีโอ
localizations.(key) object
ภาษาของข้อความที่แปลแล้วซึ่งเชื่อมโยงกับค่าคีย์ ค่าคือสตริงที่มีรหัสภาษา BCP-47
localizations.(key).title string
ชื่อวิดีโอที่แปลแล้ว
localizations.(key).description string
คำอธิบายวิดีโอที่แปลแล้ว