YouTube API . channels

Instance Methods

list(part, mine=None, id=None)

Browse the YouTube channel collection. Either the 'id' or 'mine' parameter must be set.

Method Details

list(part, mine=None, id=None)
Browse the YouTube channel collection. Either the 'id' or 'mine' parameter must be set.

Args:
  part: string, Parts of the channel resource to be returned. (required)
  mine: string, Flag indicating only return the channel ids of the authenticated user.
  id: string, YouTube IDs of the channels to be returned.

Returns:
  An object of the form:

    { # JSON template for a ChannelService.List() response.
    "channels": { # Map of channels matching the request criteria, keyed by channel id.
      "a_key": { # JSON template for a YouTube Channel.
        "kind": "youtube#channel", # The type of this API resource.
        "statistics": { # JSON template for the statistics part of a channel. # Statistics about the channel: number of subscribers, views, and comments.
          "commentCount": "A String", # Number of comments for this channel.
          "subscriberCount": "A String", # Number of subscribers to this channel.
          "videoCount": "A String", # Number of videos in the channel.
          "viewCount": "A String", # Number of times the channel has been viewed.
        },
        "contentDetails": { # JSON template for the content details part of a channel. # Information about the channel content: upload playlist id, privacy status.
          "privacyStatus": "A String", # Privacy status of the channel.
          "uploads": "A String", # The ID of the playlist containing the uploads of this channel.
        },
        "snippet": { # JSON template for the snippet part of a channel. # Basic details about the channel: title, description, and thumbnails.
          "title": "A String", # Title of the channel.
          "description": "A String", # Description of the channel.
          "thumbnails": { # Channel thumbnails.
            "a_key": { # JSON template for a thumbnail. # The name of the thumbnail.
              "url": "A String", # The URL for the thumbnail.
            },
          },
        },
        "etag": "A String", # The eTag of the channel.
        "id": "A String", # The unique ID of the channel.
      },
    },
    "kind": "youtube#channelListResponse", # The type of this API response.
    "etag": "A String", # The eTag of the response.
  }