Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13276592.6 KB
buyers

Creates a new client.

post/v1/{+parent}/clients

Path parameters

parentstring required

Required. The name of the buyer. Format: buyers/{accountId}

Request body

namestring

Output only. The resource name of the client. Format: buyers/{accountId}/clients/{clientAccountId}

displayNamestring

Required. Display name shown to publishers. Must be unique for clients without partnerClientId specified. Maximum length of 255 characters is allowed.

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'INACTIVE'

Output only. The state of the client.

sellerVisibleboolean

Whether the client will be visible to sellers.

role'CLIENT_ROLE_UNSPECIFIED' | 'CLIENT_DEAL_VIEWER' | 'CLIENT_DEAL_NEGOTIATOR' | 'CLIENT_DEAL_APPROVER'

Required. The role assigned to the client. Each role implies a set of permissions granted to the client.

partnerClientIdstring

Arbitrary unique identifier provided by the buyer. This field can be used to associate a client with an identifier in the namespace of the buyer, lookup clients by that identifier and verify whether an Authorized Buyers account of the client already exists. If present, must be unique across all the clients.

Response

Successful response