YouTube Data API v3 视频详情接口（videos.list）完整介绍与标准 JSON 返回示例

{
  "kind": "youtube#videoListResponse",
  "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/XwZ123abcDEF456\"",
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 1
  },
  "items": [
    {
      "kind": "youtube#video",
      "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
      "id": "7lCDEYXw3mM",
      "snippet": {
        "publishedAt": "2012-06-20T22:45:24.000Z",
        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "title": "Google I/O 101: Q&A On Using Google APIs",
        "description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
        "thumbnails": {
          "default": {
            "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg",
            "width": 120,
            "height": 90
          },
          "medium": {
            "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          "high": {
            "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg",
            "width": 480,
            "height": 360
          }
        },
        "channelTitle": "Google Developers",
        "tags": ["Google API", "OAuth2", "Google I/O", "开发教程"],
        "categoryId": "28",
        "liveBroadcastContent": "none"
      },
      "contentDetails": {
        "duration": "PT1H23M12S",
        "dimension": "2d",
        "definition": "hd",
        "caption": "true",
        "licensedContent": true
      },
      "statistics": {
        "viewCount": "158907",
        "likeCount": "5947",
        "favoriteCount": "0",
        "commentCount": "241"
      }
    }
  ]
}

{
  "error": {
    "code": 403,
    "message": "The request cannot be completed because you have exceeded your quota.",
    "errors": [
      {
        "message": "The request cannot be completed because you have exceeded your quota.",
        "domain": "youtube.quota",
        "reason": "quotaExceeded"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

{
  "error": {
    "code": 403,
    "message": "API key not valid. Please pass a valid API key.",
    "errors": [
      {
        "message": "API key not valid. Please pass a valid API key.",
        "domain": "usageLimits",
        "reason": "keyInvalid"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

{
  "kind": "youtube#videoListResponse",
  "etag": "\"xxx\"",
  "pageInfo": {
    "totalResults": 0,
    "resultsPerPage": 0
  },
  "items": []
}

{
  "error": {
    "code": 400,
    "message": "Missing required parameter: id",
    "errors": [
      {
        "message": "Missing required parameter: id",
        "domain": "global",
        "reason": "missingParameter",
        "location": "parameter",
        "locationType": "query"
      }
    ],
    "status": "INVALID_ARGUMENT"
  }
}