type Company (v202508)

  • A Company represents various entities involved in advertising, including agencies, advertisers, and ad networks.

  • Companies have a unique read-only id and a required name of up to 127 characters.

  • The type field specifies the kind of company, with enumerations like ADVERTISER, AGENCY, and AD_NETWORK.

  • Optional fields include address, email, phone numbers, externalId, and comment.

  • The creditStatus indicates the company's financial standing and affects line item activation and order creation.
Service
CompanyService
Dependencies
CompanyPage createCompanies() updateCompanies()
▼
Company

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

Company.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.

comment

xsd:string

Specifies the comment of the company. This attribute is optional and has a maximum length of 1024 characters.

creditStatus

Company.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

DateTime

The date and time this company was last modified.

childPublisher

ChildPublisher

Info required for when Company Type is CHILD_PUBLISHER.

viewabilityProvider

ViewabilityProvider

Info required for when Company Type is VIEWABILITY_PROVIDER.