type Company (v202508)

AI-generated Key Takeaways

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