# YouTube Analytics API . groupItems

## Instance Methods

Removes an item from a group.

Creates a group item.

Returns a collection of group items that match the API request parameters.

### Method Details

`delete(id, onBehalfOfContentOwner=None)`

    Removes an item from a group.

    Args:
      id: string, The id parameter specifies the YouTube group item ID for the group that is being deleted. (required)
      onBehalfOfContentOwner: string, 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.

`insert(body, onBehalfOfContentOwner=None)`

    Creates a group item.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "youtube#groupItem",
        "etag": "A String",
        "resource": {
          "kind": "A String",
          "id": "A String",
        },
        "groupId": "A String",
        "id": "A String",
      }

      onBehalfOfContentOwner: string, 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.

    Returns:
      An object of the form:

        {
          "kind": "youtube#groupItem",
          "etag": "A String",
          "resource": {
            "kind": "A String",
            "id": "A String",
          },
          "groupId": "A String",
          "id": "A String",
        }

`list(groupId, onBehalfOfContentOwner=None)`

    Returns a collection of group items that match the API request parameters.

    Args:
      groupId: string, The id parameter specifies the unique ID of the group for which you want to retrieve group items. (required)
      onBehalfOfContentOwner: string, 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.

    Returns:
      An object of the form:

        { # A paginated list of grouList resources returned in response to a youtubeAnalytics.groupApi.list request.
        "items": [
          {
              "kind": "youtube#groupItem",
              "etag": "A String",
              "resource": {
                "kind": "A String",
                "id": "A String",
              },
              "groupId": "A String",
              "id": "A String",
            },
        ],
        "kind": "youtube#groupItemListResponse",
        "etag": "A String",
      }