REST Resource: networks.teams

  • The Team resource allows you to manage and organize teams within your Google Ad Manager network.

  • Teams are identified by a unique name in the format networks/{networkCode}/teams/{team_id}.

  • You can use the API methods to get information about a specific team or retrieve a list of all teams.

Resource: Team

A Team defines a grouping of users and what entities they have access to.

JSON representation 
{
  "name": string,
  "displayName": string,
  "description": string,
  "status": enum (TeamStatus),
  "allCompaniesAccess": boolean,
  "allInventoryAccess": boolean,
  "accessType": enum (TeamAccessType)
}
Fields
name

string

Identifier. The resource name of the Team. Format: networks/{networkCode}/teams/{team_id}
displayName

string

Required. The name of the Team. This value has a maximum length of 127 characters.
description

string

Optional. The description of the Team. This value has a maximum length of 255 characters.
status

enum (TeamStatus)

Output only. The status of the Team. This value determines the visibility of the team in the UI.
allCompaniesAccess

boolean

Optional. Whether or not users on this team have access to all companies. If this value is true, then an error will be thrown if an attempt is made to associate this team with a Company.
allInventoryAccess

boolean

Optional. Whether or not users on this team have access to all inventory. If this value is true, then an error will be thrown if an attempt is made to associate this team with an AdUnit.
accessType

enum (TeamAccessType)

Optional. The default access to orders for users on this team.

TeamStatus

Represents the status of a team, whether it is active or inactive.

Enums
TEAM_STATUS_UNSPECIFIED Default value. This value is unused.
ACTIVE The status of an active team.
INACTIVE The status of an inactive team.

TeamAccessType

Represents the types of team access supported for orders.

Enums
TEAM_ACCESS_TYPE_UNSPECIFIED Default value. This value is unused.
NONE The level of access in which team members can't view or edit a team's orders.
READ_ONLY The level of access in which team members can only view a team's orders.
READ_WRITE The level of access in which team members can view and edit a team's orders.

Methods

batchActivate

 API to batch activate Team objects.

batchCreate

 API to batch create Team objects.

batchDeactivate

 API to batch deactivate Team objects.

batchUpdate

 API to batch update Team objects.

create

 API to create a Team object.

get

 API to retrieve a Team object.

list

 API to retrieve a list of Team objects.

patch

 API to update a Team object.