YouTube Data API v3 . youtube . v3 . videos

batchGetStats(id=None, onBehalfOfContentOwner=None, part=None, x__xgafv=None)

Retrieves a batch of VideoStat resources, possibly filtered.

Args:
  id: string, Required. Return videos with the given ids. (repeated)
  onBehalfOfContentOwner: string, Optional. **Note:** This parameter is intended exclusively for YouTube content partners. The `onBehalfOfContentOwner` parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
  part: string, Required. The `**part**` parameter specifies a comma-separated list of one or more `videoStat` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a `videoStat` resource, the `statistics` property contains `view_count` and `like_count`. As such, if you set `**part=snippet**`, the API response will contain all of those properties. (repeated)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for the Videos.stats API. Returns VideoStat information about a batch of videos. VideoStat contains a subset of the information in Video that is relevant to statistics and content details.
  "etag": "A String", # Output only. Etag of this resource.
  "items": [ # Output only. The videos' stats information.
    { # A *VideoStat* resource represents a YouTube video's stats.
      "contentDetails": { # Details about the content of a YouTube Video. This is a subset of the information in VideoContentDetails specifically for the Videos.stats API. # Output only. The VideoStatsContentDetails object contains information about the video content, including the length of the video.
        "duration": "A String", # Output only. The length of the video. The property value is a [`google.protobuf.Duration`](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) object.
      },
      "etag": "A String", # Output only. Etag of this resource.
      "id": "A String", # Output only. The ID that YouTube uses to uniquely identify the video.
      "kind": "A String", # Output only. Identifies what kind of resource this is. Value: the fixed string "youtube#videoStats".
      "snippet": { # Basic details about a video. This is a subset of the information in VideoSnippet specifically for the Videos.stats API. # Output only. The VideoStatsSnippet object contains basic details about the video, such publish time.
        "publishTime": "A String", # Output only. The date and time that the video was uploaded. The property value is a [`google.protobuf.Timestamp`](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp) object.
      },
      "statistics": { # Statistics about the video, such as the number of times the video was viewed or liked. # Output only. The VideoStatsStatistics object contains statistics about the video.
        "commentCount": "A String", # Output only. The number of comments for the video.
        "likeCount": "A String", # Output only. The number of users who have indicated that they liked the video by giving it a positive rating.
        "viewCount": "A String", # Output only. The number of times the video has been viewed.
      },
    },
  ],
  "kind": "youtube#batchGetStatsResponse", # Output only. Identifies what kind of resource this is. Value: the fixed string "youtube#batchGetStatsResponse".
}

close()

Close httplib2 connections.