A Company
represents an agency, a single advertiser or an entire advertising network.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202508
Field
id
xsd:
long
Uniquely identifies the Company
. This value is read-only and is assigned by Google when
the company is created. This attribute is required for updates.
name
xsd:
string
The full name of the company. This attribute is required and has a maximum length of 127 characters.
type
Specifies what kind of company this is. This attribute is required.
Enumerations
-
HOUSE_ADVERTISER - The publisher's own advertiser. When no outside advertiser buys its inventory, the publisher may run its own advertising campaigns.
-
HOUSE_AGENCY - The publisher's own agency.
-
ADVERTISER - A business entity that buys publisher inventory to run advertising campaigns. An advertiser is optionally associated with one or more agencies.
-
AGENCY - A business entity that offers services, such as advertising creation, placement, and management, to advertisers.
-
AD_NETWORK - A company representing multiple advertisers and agencies.
-
PARTNER - A company representing a partner.
-
CHILD_PUBLISHER - A company representing a child network.
-
VIEWABILITY_PROVIDER - A company representing a viewability provider.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
address
xsd:
string
Specifies the address of the company. This attribute is optional and has a maximum length of 1024 characters.
email
xsd:
string
Specifies the email of the company. This attribute is optional and has a maximum length of 128 characters.
faxPhone
xsd:
string
Specifies the fax phone number of the company. This attribute is optional and has a maximum length of 63 characters.
primaryPhone
xsd:
string
Specifies the primary phone number of the company. This attribute is optional and has a maximum length of 63 characters.
externalId
xsd:
string
Specifies the external ID of the company. This attribute is optional and has a maximum length of 255 characters.
creditStatus
Specifies the company's credit status. This attribute is optional and defaults to CreditStatus.ACTIVE when basic credit status settings are enabled, and CreditStatus.ON_HOLD when advanced credit status settings are enabled.
Enumerations
-
ACTIVE - When the credit status is active, all line items in all orders belonging to the company will be served. This is a Basic as well as an Advanced Credit Status setting.
-
ON_HOLD - When the credit status is on hold, the publisher cannot activate new line items of the company. However, line items that were activated before the credit status change will remain active. You can still create orders and line items for the company. This is an Advanced Credit Status setting.
-
CREDIT_STOP - When the credit status is credit stop, the publisher cannot activate new line items of the company. However, line items that were activated before the credit status change will remain active. You cannot create any new orders or line items for the company. This is an Advanced Credit Status setting.
-
INACTIVE - When the credit status is inactive, the publisher cannot activate new line items of the company. However, line items that were activated before the credit status change will remain active. You cannot create any new orders or line items for the company. It is used to mark companies with which business is to be discontinued. Such companies are not listed in Ad Manager web site. This is a Basic as well as an Advanced Credit Status setting.
-
BLOCKED - When the credit status of a company is marked blocked, then all active line items belonging to the company will stop serving with immediate effect. You cannot active new line items of the company nor can you create any new orders or line items belonging to the company. This is an Advanced Credit Status setting.
appliedLabels
AppliedLabel
[]
The set of labels applied to this company.
primaryContactId
xsd:
long
The ID of the Contact who is acting as the primary contact for this company. This attribute is optional.
appliedTeamIds
xsd:
long[]
The IDs of all teams that this company is on directly.
thirdPartyCompanyId
xsd:
int
Specifies the ID of the Google-recognized canonicalized form of this company. This attribute is optional.
lastModifiedDateTime
The date and time this company was last modified.
childPublisher
Info required for when Company Type is CHILD_PUBLISHER.
viewabilityProvider
Info required for when Company Type is VIEWABILITY_PROVIDER.
commentxsd: stringSpecifies the comment of the company. This attribute is optional and has a maximum length of 1024 characters.