วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง 
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 | 
      etagEtag ของทรัพยากรนี้  | 
    
id | 
      stringรหัสที่ YouTube ใช้เพื่อระบุวิดีโอโดยไม่ซ้ำกัน  | 
    
snippet | 
      objectออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับวิดีโอ เช่น ชื่อ คำอธิบาย และหมวดหมู่ | 
    
snippet.publishedAt | 
      datetimeวันที่และเวลาที่เผยแพร่วิดีโอ โปรดทราบว่าเวลานี้อาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ ตัวอย่างเช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัวแล้วทำให้เป็นแบบสาธารณะในภายหลัง พร็อพเพอร์ตี้นี้จะระบุเวลาที่วิดีโอเป็นแบบสาธารณะ มีกรณีพิเศษ 2 กรณีดังนี้ 
  | 
    
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คีย์-ค่าที่ใช้ได้มีดังนี้ 
  | 
    
snippet.thumbnails.(key).url | 
      stringURL ของรูปภาพ  | 
    
snippet.thumbnails.(key).width | 
      unsigned integerความกว้างของรูปภาพ  | 
    
snippet.thumbnails.(key).height | 
      unsigned integerความสูงของรูปภาพ  | 
    
snippet.channelTitle | 
      stringชื่อช่องของช่องที่เป็นเจ้าของวิดีโอ  | 
    
snippet.tags[] | 
      listรายการแท็กคีย์เวิร์ดที่เชื่อมโยงกับวิดีโอ แท็กอาจมีเว้นวรรคได้ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 500 อักขระ โปรดทราบกฎต่อไปนี้เกี่ยวกับวิธีคำนวณจำนวนอักขระสูงสุด 
  | 
    
snippet.categoryId | 
      stringหมวดหมู่วิดีโอ YouTube ที่เชื่อมโยงกับวิดีโอ คุณต้องตั้งค่าพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และอัปเดตส่วน snippet ของทรัพยากร video | 
    
snippet.liveBroadcastContent | 
      stringระบุว่าวิดีโอเป็นการออกอากาศสดที่กำลังจะเผยแพร่/กำลังเผยแพร่อยู่หรือไม่ หรือเป็น "none" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กําลังจะมีขึ้น/กำลังถ่ายทอดสด ค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
snippet.defaultLanguage | 
      stringภาษาของข้อความในพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร video | 
    
snippet.localized | 
      objectออบเจ็กต์ snippet.localized มีชื่อและคำอธิบายที่แปลแล้วสำหรับวิดีโอ หรือชื่อในภาษาเริ่มต้นสำหรับข้อมูลเมตาของวิดีโอ 
 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) หรือมีให้บริการในรูปแบบความละเอียดมาตรฐานเท่านั้นค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.caption | 
      stringระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.licensedContent | 
      booleanระบุว่าวิดีโอแสดงเนื้อหาที่ได้รับอนุญาตหรือไม่ ซึ่งหมายความว่าเนื้อหาดังกล่าวได้รับการอัปโหลดไปยังช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube แล้วพาร์ทเนอร์รายดังกล่าวอ้างสิทธิ์ในเนื้อหา  | 
    
contentDetails.regionRestriction | 
      objectออบเจ็กต์ regionRestriction มีข้อมูลเกี่ยวกับประเทศที่รับชมวิดีโอได้ (หรือไม่ได้) ออบเจ็กต์จะมีพร็อพเพอร์ตี้ contentDetails.regionRestriction.allowed หรือพร็อพเพอร์ตี้ contentDetails.regionRestriction.blocked | 
    
contentDetails.regionRestriction.allowed[] | 
      listรายการรหัสภูมิภาคที่ระบุประเทศที่รับชมวิดีโอได้ หากพร็อพเพอร์ตี้นี้แสดงอยู่และไม่มีประเทศแสดงอยู่ในค่า ระบบจะบล็อกวิดีโอไม่ให้ปรากฏในประเทศนั้น หากพร็อพเพอร์ตี้นี้มีอยู่และมีรายการว่างเปล่า วิดีโอจะถูกบล็อกในทุกประเทศ  | 
    
contentDetails.regionRestriction.blocked[] | 
      listรายการรหัสภูมิภาคที่ระบุประเทศที่วิดีโอถูกบล็อก หากพร็อพเพอร์ตี้นี้แสดงอยู่และไม่มีประเทศแสดงอยู่ในค่า แสดงว่าวิดีโอจะรับชมได้ในประเทศนั้น หากพร็อพเพอร์ตี้นี้มีอยู่และมีรายการว่าง วิดีโอจะดูได้ในทุกประเทศ  | 
    
contentDetails.contentRating | 
      objectระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ  | 
    
contentDetails.contentRating.acbRating | 
      stringการจัดประเภทของคณะกรรมการการจัดประเภทของออสเตรเลีย (ACB) หรือหน่วยงานกำกับดูแลการสื่อสารและสื่อของออสเตรเลีย (ACMA) สำหรับวิดีโอ การจัดประเภทของ ACMA ใช้เพื่อจัดประเภทรายการทีวีสำหรับเด็ก ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.agcomRating | 
      stringการจัดประเภทวิดีโอจาก Autorità per le Garanzie nelle Comunicazioni (AGCOM) ของอิตาลี ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.anatelRating | 
      stringการจัดประเภท Anatel (Asociación Nacional de Televisión) ของวิดีโอสำหรับโทรทัศน์ชิลี ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.bbfcRating | 
      stringการจัดประเภทของคณะกรรมการจัดประเภทภาพยนตร์ของสหราชอาณาจักร (BBFC) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.bfvcRating | 
      stringการจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์และวีดิทัศน์แห่งประเทศไทย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.bmukkRating | 
      stringการจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทสื่อของออสเตรีย (Bundesministerium für Unterricht, Kunst und Kultur) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.catvRating | 
      stringระบบการจัดประเภทสำหรับทีวีของแคนาดา - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการกิจการกระจายเสียง กิจการโทรทัศน์ และกิจการโทรคมนาคมของแคนาดา (CRTC) สําหรับการออกอากาศภาษาอังกฤษของแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.catvfrRating | 
      stringการจัดประเภทวิดีโอจากคณะกรรมการกิจการกระจายเสียง กิจการโทรทัศน์ และกิจการโทรคมนาคมแห่งแคนาดา (CRTC) สําหรับการออกอากาศภาษาฝรั่งเศสในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.cbfcRating | 
      stringการจัดประเภทของคณะกรรมการกลางพิจารณาภาพยนตร์ (CBFC - อินเดีย) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.cccRating | 
      stringการจัดประเภทของ Consejo de Calificación Cinematográfica (ชิลี) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.cceRating | 
      stringการจัดประเภทของวิดีโอจาก Comissão de Classificação de Espect´culos ของโปรตุเกส ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.chfilmRating | 
      stringการจัดประเภทของวิดีโอในสวิตเซอร์แลนด์ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.chvrsRating | 
      stringการจัดประเภทของระบบการจัดประเภทวิดีโอสำหรับใช้ในบ้านของแคนาดา (CHVRS) ของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.cicfRating | 
      stringการจัดประเภทวิดีโอจาก Commission de Contrôle des Films (เบลเยียม) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.cnaRating | 
      stringการจัดประเภทวิดีโอจาก CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) ของโรมาเนีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.cncRating | 
      stringระบบการจัดประเภทในฝรั่งเศส - Commission de classification cinematographique ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.csaRating | 
      stringการจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศส ซึ่งจัดประเภทเนื้อหาที่ออกอากาศ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.cscfRating | 
      stringการจัดประเภทวิดีโอจาก Commission de surveillance de la classification des films (CSCF) ของลักเซมเบิร์ก ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.czfilmRating | 
      stringการจัดประเภทของวิดีโอในสาธารณรัฐเช็ก ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.djctqRating | 
      stringการจัดประเภทของ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - บราซิล) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.djctqRatingReasons[] | 
      listเหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภท DJCQT (บราซิล)  | 
    
contentDetails.contentRating.ecbmctRating | 
      stringระบบการจัดประเภทในตุรกี - คณะกรรมการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.eefilmRating | 
      stringการจัดประเภทของวิดีโอในเอสโตเนีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.egfilmRating | 
      stringการจัดประเภทของวิดีโอในอียิปต์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.eirinRating | 
      stringการจัดประเภท Eirin (映倫) ของวิดีโอ Eirin คือระบบการจัดประเภทของญี่ปุ่น ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.fcbmRating | 
      stringการจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์ของมาเลเซีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.fcoRating | 
      stringการจัดประเภทของวิดีโอจากสำนักงานบริหารภาพยนตร์ หนังสือพิมพ์ และบทความของฮ่องกง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.fmocRating | 
      stringเราได้เลิกใช้งานพร็อพเพอร์ตี้นี้แล้วตั้งแต่วันที่ 2 พฤศจิกายน 2015 ให้ใช้พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating แทนการจัดประเภทของวิดีโอโดย Centre national du cinéma et de l'image animé (กระทรวงวัฒนธรรมฝรั่งเศส) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.fpbRating | 
      stringการจัดประเภทของวิดีโอจากคณะกรรมการภาพยนตร์และสื่อสิ่งพิมพ์ของแอฟริกาใต้ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.fpbRatingReasons[] | 
      listเหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภท FPB (แอฟริกาใต้)  | 
    
contentDetails.contentRating.fskRating | 
      stringการจัดประเภท Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - เยอรมนี) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.grfilmRating | 
      stringการจัดประเภทของวิดีโอในกรีซ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.icaaRating | 
      stringการจัดประเภทของ Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - สเปน) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.ifcoRating | 
      stringการจัดประเภทของวิดีโอโดยสำนักงานการจัดประเภทภาพยนตร์แห่งไอร์แลนด์ (IFCO - ไอร์แลนด์) ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.ilfilmRating | 
      stringการจัดประเภทของวิดีโอในอิสราเอล ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.incaaRating | 
      stringการจัดประเภทของ INCAA (Instituto Nacional de Cine y Artes Audiovisuales - อาร์เจนตินา) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.kfcbRating | 
      stringการจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของ Kenya ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.kijkwijzerRating | 
      stringvoor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.kmrbRating | 
      stringการจัดประเภทของคณะกรรมการการจัดประเภทสื่อของเกาหลี (영상물등급위원회) สำหรับวิดีโอ KMRB จัดประเภทวิดีโอในเกาหลีใต้ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.lsfRating | 
      stringการจัดประเภทของวิดีโอจาก Lembaga Sensor Film ของอินโดนีเซีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.mccaaRating | 
      stringการจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ตามอายุของมอลตา ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.mccypRating | 
      stringการจัดประเภทวิดีโอจาก Media Council for Children and Young People ของ Danish Film Institute (Det Danske Filminstitut) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.mcstRating | 
      stringระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.mdaRating | 
      stringการจัดประเภทของวิดีโอจากหน่วยงานพัฒนาสื่อ (Media Development Authority หรือ MDA) ของสิงคโปร์ และโดยเฉพาะคณะกรรมการตรวจสอบภาพยนตร์ (Board of Film Censors หรือ BFC) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.medietilsynetRating | 
      stringการจัดประเภทวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานกำกับดูแลสื่อของนอร์เวย์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.mekuRating | 
      stringการจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (สถาบันภาพและเสียงแห่งชาติ) ของฟินแลนด์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.mibacRating | 
      stringการจัดประเภทวิดีโอจาก Ministero dei Beni e delle Attività Culturali e del Turismo (อิตาลี) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.mocRating | 
      stringการจัดประเภทของ Ministerio de Cultura (โคลอมเบีย) สำหรับวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.moctwRating | 
      stringการจัดประเภทของวิดีโอจากกระทรวงวัฒนธรรม (文化部) ของไต้หวัน ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.mpaaRating | 
      stringการจัดประเภทของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) สำหรับวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.mpaatRating | 
      stringการจัดประเภทของตัวอย่างภาพยนตร์และตัวอย่างเพลงโดยสมาคมภาพยนตร์อเมริกัน ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.mtrcbRating | 
      stringการจัดประเภทของวิดีโอจากคณะกรรมการตรวจสอบและจัดประเภทภาพยนตร์และโทรทัศน์ (ฟิลิปปินส์) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.nbcRating | 
      stringการจัดประเภทของวิดีโอจากสำนักการจัดประเภทแห่งชาติของมัลดีฟส์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.nfrcRating | 
      stringการจัดประเภทวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.nfvcbRating | 
      stringการจัดประเภทวิดีโอจากคณะกรรมการตรวจสอบภาพยนตร์และวิดีโอแห่งชาติของไนจีเรีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.nkclvRating | 
      stringการจัดประเภทของวิดีโอจาก Nacionãlais Kino centrs (ศูนย์ภาพยนตร์แห่งชาติของลัตเวีย) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.oflcRating | 
      stringการจัดประเภทของ Office of Film and Literature Classification (OFLC - นิวซีแลนด์) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.pefilmRating | 
      stringการจัดประเภทของวิดีโอในเปรู ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.resorteviolenciaRating | 
      stringการจัดประเภทของวิดีโอในเวเนซุเอลา ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.rtcRating | 
      stringการจัดประเภทของวิดีโอโดยสำนักผู้อำนวยการทั่วไปด้านวิทยุ ทีวี และภาพยนตร์ (เม็กซิโก) ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.rteRating | 
      stringการจัดประเภทของวิดีโอจาก Raidió Teilifís Éireann ของไอร์แลนด์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.russiaRating | 
      stringการจัดประเภทของ National Film Registry of the Russian Federation (MKRF - Russia) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.skfilmRating | 
      stringการจัดประเภทของวิดีโอในสโลวาเกีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.smaisRating | 
      stringการจัดประเภทของวิดีโอในไอซ์แลนด์ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.smsaRating | 
      stringการจัดประเภทของวิดีโอจาก Statens medieråd (คณะกรรมการสื่อแห่งชาติของสวีเดน) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
contentDetails.contentRating.tvpgRating | 
      stringการจัดประเภทตามหลักเกณฑ์ด้านผู้ปกครองสำหรับทีวี (TVPG) ของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.contentRating.ytRating | 
      stringการจัดประเภทที่ YouTube ใช้เพื่อระบุเนื้อหาที่มีการจำกัดอายุผู้ชม ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.projection | 
      stringระบุรูปแบบการฉายของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
contentDetails.hasCustomThumbnail | 
      booleanระบุว่าผู้อัปโหลดวิดีโอได้ระบุรูปภาพขนาดย่อที่กำหนดเองสำหรับวิดีโอหรือไม่ เฉพาะผู้อัปโหลดวิดีโอเท่านั้นที่จะเห็นพร็อพเพอร์ตี้นี้  | 
    
status | 
      objectออบเจ็กต์ status มีข้อมูลเกี่ยวกับการอัปโหลด การประมวลผล และสถานะความเป็นส่วนตัวของวิดีโอ | 
    
status.uploadStatus | 
      stringสถานะของวิดีโอที่อัปโหลด ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
status.failureReason | 
      stringค่านี้อธิบายสาเหตุที่วิดีโออัปโหลดไม่สำเร็จ พร็อพเพอร์ตี้นี้จะแสดงเฉพาะในกรณีที่พร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดไม่สำเร็จค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
status.rejectionReason | 
      stringค่านี้อธิบายสาเหตุที่ YouTube ปฏิเสธวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดถูกปฏิเสธค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
status.privacyStatus | 
      stringสถานะความเป็นส่วนตัวของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
status.publishAt | 
      datetimeวันที่และเวลาที่กําหนดเวลาเผยแพร่วิดีโอ โดยคุณจะตั้งค่าได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็นแบบส่วนตัวเท่านั้น ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 โปรดทราบประเด็นเพิ่มเติม 2 ข้อต่อไปนี้เกี่ยวกับลักษณะการทํางานของพร็อพเพอร์ตี้นี้ 
  | 
    
status.license | 
      stringใบอนุญาตของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่ 
  | 
    
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จำนวนครั้งที่มีการดูวิดีโอ ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป สำหรับ Shorts ผลลัพธ์ของ viewCount จะเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ  | 
    
statistics.likeCount | 
      unsigned longจำนวนผู้ใช้ที่ระบุว่าชอบวิดีโอ  | 
    
statistics.dislikeCount | 
      unsigned longหมายเหตุ: เราได้ทำให้พร็อพเพอร์ตี้  
        statistics.dislikeCount เป็นแบบส่วนตัวแล้วเมื่อวันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะรวมอยู่ในการตอบกลับของ API ก็ต่อเมื่อเจ้าของวิดีโอตรวจสอบสิทธิ์คําขอ API เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไขจำนวนผู้ใช้ที่ระบุว่าไม่ชอบวิดีโอ  | 
    
statistics.favoriteCount | 
      unsigned longหมายเหตุ: เราได้เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว การเลิกใช้งานจะมีผลตั้งแต่วันที่ 28 สิงหาคม 2015 ตอนนี้ค่าของพร็อพเพอร์ตี้จะตั้งค่าเป็น 0 เสมอ | 
    
statistics.commentCount | 
      unsigned longจำนวนความคิดเห็นของวิดีโอ  | 
    
paidProductPlacementDetails | 
      objectออบเจ็กต์ paidProductPlacementDetails มีข้อมูลเกี่ยวกับการแสดงผลิตภัณฑ์แบบชำระเงินในวิดีโอ | 
    
paidProductPlacementDetails.hasPaidProductPlacement | 
      booleanตั้งค่าเป็น true หากเนื้อหามีการแสดงผลิตภัณฑ์แบบชำระเงิน ค่าเริ่มต้นคือ false | 
    
player | 
      objectออบเจ็กต์ player มีข้อมูลที่คุณจะใช้ในการเล่นวิดีโอในโปรแกรมเล่นที่ฝัง | 
    
player.embedHtml | 
      stringแท็ก <iframe> ที่ใช้ฝังเพลเยอร์ที่เล่นวิดีโอ | 
    
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 ประมวลผลเฉพาะไฟล์วิดีโอ แต่ช่องนี้จะปรากฏขึ้นไม่ว่าจะอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่น ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
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 ต้องหมุนเนื้อหาต้นฉบับเพื่อแสดงวิดีโออย่างถูกต้อง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
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 ต่อไปนี้ 
  | 
    
processingDetails | 
      objectออบเจ็กต์ processingDetails จะรวมข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ในออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและเวลาโดยประมาณที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จ ส่วนนี้ยังระบุว่าวิดีโอมีข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพปก หรือไม่ออบเจ็กต์ processingProgress ได้รับการออกแบบมาเพื่อใช้โพลเพื่อให้วิดีโอที่อัปโหลดติดตามความคืบหน้าที่ YouTube ดำเนินการประมวลผลไฟล์วิดีโอที่อัปโหลด เจ้าของวิดีโอเท่านั้นที่เรียกข้อมูลนี้ได้ | 
    
processingDetails.processingStatus | 
      stringสถานะการประมวลผลของวิดีโอ ค่านี้บ่งชี้ว่า YouTube ประมวลผลวิดีโอได้หรือไม่ หรือวิดีโอยังอยู่ระหว่างการประมวลผล ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
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ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
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 ในท้ายที่สุดค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
suggestions.processingWarnings[] | 
      listรายการเหตุผลที่ YouTube อาจมีปัญหาในการแปลงวิดีโอที่อัปโหลดหรืออาจส่งผลให้เกิดการเปลี่ยนรูปแบบที่ไม่ถูกต้อง คำเตือนเหล่านี้สร้างขึ้นก่อนที่ YouTube จะประมวลผลไฟล์วิดีโอที่อัปโหลด นอกจากนี้ สถานะยังระบุปัญหาที่ไม่ได้บ่งชี้ว่าการประมวลผลวิดีโอจะล้มเหลวเสมอไป แต่อาจทำให้เกิดปัญหา เช่น ปัญหาการซิงค์ สัญญาณรบกวนวิดีโอ หรือไม่มีแทร็กเสียง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 
  | 
    
suggestions.processingHints[] | 
      listรายการคำแนะนำที่อาจช่วยปรับปรุงความสามารถของ YouTube ในการจัดการวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
suggestions.tagSuggestions[] | 
      listรายการแท็กคีย์เวิร์ดที่เพิ่มลงในข้อมูลเมตาของวิดีโอได้เพื่อเพิ่มโอกาสที่ผู้ใช้จะพบวิดีโอของคุณเมื่อค้นหาหรือเรียกดูบน YouTube  | 
    
suggestions.tagSuggestions[].tag | 
      stringแท็กคีย์เวิร์ดที่แนะนำสำหรับวิดีโอ  | 
    
suggestions.tagSuggestions[].categoryRestricts[] | 
      listชุดหมวดหมู่วิดีโอที่แท็กมีความเกี่ยวข้อง คุณสามารถใช้ข้อมูลนี้เพื่อแสดงแท็กแนะนำที่เหมาะสมตามหมวดหมู่วิดีโอที่ผู้อัปโหลดวิดีโอเชื่อมโยงกับวิดีโอ โดยค่าเริ่มต้น คำแนะนำแท็กจะเกี่ยวข้องกับทุกหมวดหมู่หากไม่มีการกําหนดข้อจํากัดสําหรับคีย์เวิร์ด  | 
    
suggestions.editorSuggestions[] | 
      listรายการการดำเนินการแก้ไขวิดีโอที่อาจปรับปรุงคุณภาพวิดีโอหรือประสบการณ์การเล่นวิดีโอที่อัปโหลด ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ 
  | 
    
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คำอธิบายวิดีโอที่แปลแล้ว  |