Create a user

AI-generated Key Takeaways

• Admins can create users with access to resources they manage, including sub-resources.

• New users require a Google Account and at least one assigned user role for access.

• The user.create method enables user creation, potentially adding roles to existing, inaccessible Display & Video 360 users without error.

• Code samples in Java, Python, and PHP demonstrate creating a standard access user for an advertiser.

If assigned the Admin role for a resource, you can create a user with access to that resource or those under it.

Users are created through the user.create method.

Note: If you attempt to create a user with an email address associated with an existing Display & Video 360 user that you cannot access, no error will be returned. The new assigned user roles will be added to the existing user resource.

A new user's email address must have a corresponding Google Account, which can be created for an existing email address. The user resource created must also include at least one assigned user role.

Here's an example of how to create a new user with standard access to an advertiser:

Java

// Create the user structure.
User user = new User();
user.setEmail(email-address);
user.setDisplayName(display-name);

// Create the assigned user role structure.
AssignedUserRole assignedUserRole = new AssignedUserRole();
assignedUserRole.setAdvertiserId(advertiser-id);
assignedUserRole.setUserRole("STANDARD");

// Add assigned user role list to the user.
user.setAssignedUserRoles(ImmutableList.of(assignedUserRole));

// Configure the create request.
Users.Create request = service.users().create(user);

// Create the user.
User response = request.execute();

// Display the user.
System.out.printf("User %s was created with email %s.",
    response.getName(),
    response.getEmail());

Python

# Create a user object.
user_obj = {
    'email': email-address,
    'displayName': display-name,
    'assignedUserRoles': [
        {
            'advertiserId': advertiser-id,
            'userRole': 'STANDARD'
        }
    ]
}

# Build request.
request = service.users().create(
    body=user_obj
)

# Execute request.
response = request.execute()

# Display the new user.
print('User %s was created with email %s.'
      % (response['name'], response['email']))

PHP

// Create the user structure.
$user = new Google_Service_DisplayVideo_User();
$user->setEmail(email-address);
$user->setDisplayName(display-name);

// Create the assigned user role structure.
$assignedUserRole = new Google_Service_DisplayVideo_AssignedUserRole();
$assignedUserRole->setAdvertiserId(advertiser-id);
$assignedUserRole->setUserRole('STANDARD');

// Add assigned user role list to the user.
$user->setAssignedUserRoles(array($assignedUserRole));

// Call the API, creating the user with the assigned user role.
$result = $this->service->users->create($user);

// Display the user.
printf(
    'User %s was created with email %s.\n',
    $result['name'],
    $result['email']
);