Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set toUS. It is also not applicable for marketplaces or marketplace sellers.
Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set toUS. It is also not applicable for marketplaces or marketplace sellers.
Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set toUS. It is also not applicable for marketplaces or marketplace sellers.
Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set toUS. It is also not applicable for marketplaces or marketplace sellers.
Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set toUS. It is also not applicable for marketplaces.
PromotionsConsent
All possible settings regarding promotions related to the business identity.
Enums
PROMOTIONS_CONSENT_UNSPECIFIED
Default value indicating that no selection was made.
PROMOTIONS_CONSENT_GIVEN
Indicates that the account consented to having their business identity used for promotions.
PROMOTIONS_CONSENT_DENIED
Indicates that the account did not consent to having their business identity used for promotions.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-31 UTC."],[],[],null,["# REST Resource: accounts.businessIdentity\n\n- [Resource: BusinessIdentity](#BusinessIdentity)\n - [JSON representation](#BusinessIdentity.SCHEMA_REPRESENTATION)\n- [PromotionsConsent](#PromotionsConsent)\n- [IdentityAttribute](#IdentityAttribute)\n - [JSON representation](#IdentityAttribute.SCHEMA_REPRESENTATION)\n- [IdentityDeclaration](#IdentityDeclaration)\n- [Methods](#METHODS_SUMMARY)\n\nResource: BusinessIdentity\n--------------------------\n\nCollection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"promotionsConsent\": enum (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#PromotionsConsent), \"blackOwned\": { object (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute) }, \"womenOwned\": { object (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute) }, \"veteranOwned\": { object (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute) }, \"latinoOwned\": { object (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute) }, \"smallBusiness\": { object (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute) } } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity` |\n| `promotionsConsent` | `enum (`[PromotionsConsent](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#PromotionsConsent)`)` Required. Whether the identity attributes may be used for promotions. |\n| `blackOwned` | `object (`[IdentityAttribute](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)`)` Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |\n| `womenOwned` | `object (`[IdentityAttribute](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)`)` Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |\n| `veteranOwned` | `object (`[IdentityAttribute](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)`)` Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |\n| `latinoOwned` | `object (`[IdentityAttribute](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)`)` Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |\n| `smallBusiness` | `object (`[IdentityAttribute](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)`)` Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces. |\n\nPromotionsConsent\n-----------------\n\nAll possible settings regarding promotions related to the business identity.\n\n| Enums ||\n|----------------------------------|---------------------------------------------------------------------------------------------------|\n| `PROMOTIONS_CONSENT_UNSPECIFIED` | Default value indicating that no selection was made. |\n| `PROMOTIONS_CONSENT_GIVEN` | Indicates that the account consented to having their business identity used for promotions. |\n| `PROMOTIONS_CONSENT_DENIED` | Indicates that the account did not consent to having their business identity used for promotions. |\n\nIdentityAttribute\n-----------------\n\nAll information related to an identity attribute.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"identityDeclaration\": enum (/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityDeclaration) } ``` |\n\n| Fields ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `identityDeclaration` | `enum (`[IdentityDeclaration](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityDeclaration)`)` Required. The declaration of identity for this attribute. |\n\nIdentityDeclaration\n-------------------\n\nAll possible settings regarding the declaration of an identity.\n\n| Enums ||\n|------------------------------------|------------------------------------------------------------------|\n| `IDENTITY_DECLARATION_UNSPECIFIED` | Default value indicating that no selection was made. |\n| `SELF_IDENTIFIES_AS` | Indicates that the account identifies with the attribute. |\n| `DOES_NOT_SELF_IDENTIFY_AS` | Indicates that the account does not identify with the attribute. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|\n| ### [getBusinessIdentity](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity/getBusinessIdentity) | Retrieves the business identity of an account. |\n| ### [updateBusinessIdentity](/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity/updateBusinessIdentity) | Updates the business identity of an account. |"]]
