Defines participation in a given program for the specified account.
Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the Free product listings program, which enables products from a business's store to be shown across Google for free.
The following list is the available set of program resource IDs accessible through the API:
Output only. The participation state of the account in the program.
activeRegionCodes[]
string
Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met.
Region codes are defined by CLDR. This is either a country where the program applies specifically to that country or 001 when the program applies globally.
Output only. The URL of a help page describing the requirement.
affectedRegionCodes[]
string
Output only. The regions that are currently affected by this requirement not being met.
Region codes are defined by CLDR. This is either a country where the program applies specifically to that country or 001 when the program applies globally.
[[["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-06-06 UTC."],[[["\u003cp\u003eThe Program resource defines account participation in programs, which extend merchant account functionality, such as free product listings.\u003c/p\u003e\n"],["\u003cp\u003ePrograms have different participation states: \u003ccode\u003eNOT_ELIGIBLE\u003c/code\u003e, \u003ccode\u003eELIGIBLE\u003c/code\u003e, and \u003ccode\u003eENABLED\u003c/code\u003e, reflecting the account's status within the program.\u003c/p\u003e\n"],["\u003cp\u003eUnmet requirements for program participation are detailed, including the requirement title, relevant documentation, and affected regions.\u003c/p\u003e\n"],["\u003cp\u003eAccounts can enable or disable program participation and retrieve program details through dedicated methods.\u003c/p\u003e\n"]]],["Programs allow merchants to add features to their accounts, like \"free-listings.\" Each program has a `name`, `documentationUri`, `state` (e.g., `NOT_ELIGIBLE`, `ENABLED`), `activeRegionCodes`, and `unmetRequirements`. Requirements have a `title`, `documentationUri`, and `affectedRegionCodes`. Actions include `enable` or `disable` participation. You can `get` a specific program or `list` all programs, with program resource IDs such as `free-listings`, `shopping-ads`, and `youtube-shopping-checkout` being available.\n"],null,["- [Resource: Program](#Program)\n - [JSON representation](#Program.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [Requirement](#Requirement)\n - [JSON representation](#Requirement.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Program Defines participation in a given program for the specified account.\n\nPrograms provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free.\n\nThe following list is the available set of program resource IDs accessible through the API:\n\n- `free-listings`\n- `shopping-ads`\n- `youtube-shopping-checkout`\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"documentationUri\": string, \"state\": enum (/merchant/api/reference/rest/accounts_v1beta/accounts.programs#State), \"activeRegionCodes\": [ string ], \"unmetRequirements\": [ { object (/merchant/api/reference/rest/accounts_v1beta/accounts.programs#Requirement) } ] } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the program. Format: `accounts/{account}/programs/{program}` |\n| `documentationUri` | `string` Output only. The URL of a Merchant Center help page describing the program. |\n| `state` | `enum (`[State](/merchant/api/reference/rest/accounts_v1beta/accounts.programs#State)`)` Output only. The participation state of the account in the program. |\n| `activeRegionCodes[]` | `string` Output only. The regions in which the account is actively participating in the program. Active regions are defined as those where all program requirements affecting the regions have been met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. |\n| `unmetRequirements[]` | `object (`[Requirement](/merchant/api/reference/rest/accounts_v1beta/accounts.programs#Requirement)`)` Output only. The requirements that the account has not yet satisfied that are affecting participation in the program. |\n\nState Possible program participation states for the account.\n\n| Enums ||\n|---------------------|------------------------------------------------------------|\n| `STATE_UNSPECIFIED` | Default value. This value is unused. |\n| `NOT_ELIGIBLE` | The account is not eligible to participate in the program. |\n| `ELIGIBLE` | The account is eligible to participate in the program. |\n| `ENABLED` | The program is enabled for the account. |\n\nRequirement Defines a requirement specified for participation in the program.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------|\n| ``` { \"title\": string, \"documentationUri\": string, \"affectedRegionCodes\": [ string ] } ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `title` | `string` Output only. Name of the requirement. |\n| `documentationUri` | `string` Output only. The URL of a help page describing the requirement. |\n| `affectedRegionCodes[]` | `string` Output only. The regions that are currently affected by this requirement not being met. Region codes are defined by [CLDR](https://cldr.unicode.org/). This is either a country where the program applies specifically to that country or `001` when the program applies globally. |\n\n| Methods ||\n|-----------------------------------------------------------------------------------|-----------------------------------------------------------------|\n| [disable](/merchant/api/reference/rest/accounts_v1beta/accounts.programs/disable) | Disable participation in the specified program for the account. |\n| [enable](/merchant/api/reference/rest/accounts_v1beta/accounts.programs/enable) | Enable participation in the specified program for the account. |\n| [get](/merchant/api/reference/rest/accounts_v1beta/accounts.programs/get) | Retrieves the specified program for the account. |\n| [list](/merchant/api/reference/rest/accounts_v1beta/accounts.programs/list) | Retrieves all programs for the account. |"]]
