YouTube Data API . fanFundingEvents

list(part, pageToken=None, hl=None, maxResults=None)

Lists fan funding events for a channel.

Args:
  part: string, The part parameter specifies the fanFundingEvent resource parts that the API response will include. Supported values are id and snippet. (required)
  pageToken: string, The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
  hl: string, The hl parameter instructs the API to retrieve localized resource metadata for a specific application language that the YouTube website supports. The parameter value must be a language code included in the list returned by the i18nLanguages.list method.

If localized resource details are available in that language, the resource's snippet.localized object will contain the localized values. However, if localized details are not available, the snippet.localized object will contain resource details in the resource's default language.
  maxResults: integer, The maxResults parameter specifies the maximum number of items that should be returned in the result set.

Returns:
  An object of the form:

    {
    "eventId": "A String", # Serialized EventId of the request which produced this response.
    "nextPageToken": "A String", # The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.
    "kind": "youtube#fanFundingEventListResponse", # Identifies what kind of resource this is. Value: the fixed string "youtube#fanFundingEventListResponse".
    "visitorId": "A String", # The visitorId identifies the visitor.
    "items": [ # A list of fan funding events that match the request criteria.
      { # A fanFundingEvent resource represents a fan funding event on a YouTube channel. Fan funding events occur when a user gives one-time monetary support to the channel owner.
        "snippet": { # The snippet object contains basic details about the fan funding event.
          "commentText": "A String", # The text contents of the comment left by the user.
          "channelId": "A String", # Channel id where the funding event occurred.
          "supporterDetails": { # Details about the supporter. Only filled if the event was made public by the user.
            "channelId": "A String", # The YouTube channel ID.
            "displayName": "A String", # The channel's display name.
            "profileImageUrl": "A String", # The channels's avatar URL.
            "channelUrl": "A String", # The channel's URL.
          },
          "amountMicros": "A String", # The amount of funding in micros of fund_currency. e.g., 1 is represented
          "currency": "A String", # The currency in which the fund was made. ISO 4217.
          "displayString": "A String", # A rendered string that displays the fund amount and currency (e.g., "$1.00"). The string is rendered for the given language.
          "createdAt": "A String", # The date and time when the funding occurred. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
        },
        "kind": "youtube#fanFundingEvent", # Identifies what kind of resource this is. Value: the fixed string "youtube#fanFundingEvent".
        "etag": "A String", # Etag of this resource.
        "id": "A String", # The ID that YouTube assigns to uniquely identify the fan funding event.
      },
    ],
    "tokenPagination": { # Stub token pagination template to suppress results.
    },
    "etag": "A String", # Etag of this resource.
    "pageInfo": { # Paging details for lists of resources, including total number of items available and number of resources returned in a single page.
      "totalResults": 42, # The total number of results in the result set.
      "resultsPerPage": 42, # The number of results included in the API response.
    },
  }

list_next(previous_request, previous_response)

Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.