Package google.shopping.merchant.issueresolution.v1beta

Index

AggregateProductStatusesService

Service to manage aggregate product statuses.

ListAggregateProductStatuses

rpc ListAggregateProductStatuses(ListAggregateProductStatusesRequest) returns (ListAggregateProductStatusesResponse)

Lists the AggregateProductStatuses resources for your merchant account. The response might contain fewer items than specified by pageSize. If pageToken was returned in previous request, it can be used to obtain additional results.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

IssueResolutionService

Service to provide an issue resolution content for account issues and product issues.

RenderAccountIssues

rpc RenderAccountIssues(RenderAccountIssuesRequest) returns (RenderAccountIssuesResponse)

Provide a list of business's account issues with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.
RenderProductIssues

rpc RenderProductIssues(RenderProductIssuesRequest) returns (RenderProductIssuesResponse)

Provide a list of issues for business's product with an issue resolution content and available actions. This content and actions are meant to be rendered and shown in third-party applications.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.
TriggerAction

rpc TriggerAction(TriggerActionRequest) returns (TriggerActionResponse)

Start an action. The action can be requested by a business in third-party application. Before the business can request the action, the third-party application needs to show them action specific content and display a user input form.

The action can be successfully started only once all required inputs are provided. If any required input is missing, or invalid value was provided, the service will return 400 error. Validation errors will contain Ids for all problematic field together with translated, human readable error messages that can be shown to the user.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

Action

An actionable step that can be executed to solve the issue.

Fields
button_label

string

Label of the action button.
is_available

bool

Controlling whether the button is active or disabled. The value is 'false' when the action was already requested or is not available. If the action is not available then a reason will be present. If (your) third-party application shows a disabled button for action that is not available, then it should also show reasons.
reasons[]

Reason

List of reasons why the action is not available. The list of reasons is empty if the action is available. If there is only one reason, it can be displayed next to the disabled button. If there are more reasons, all of them should be displayed, for example in a pop-up dialog.
Union field action. An actionable step that can be executed to solve the issue. action can be only one of the following:
builtin_simple_action

BuiltInSimpleAction

Action implemented and performed in (your) third-party application. The application should point the business to the place, where they can access the corresponding functionality or provide instructions, if the specific functionality is not available.
external_action

ExternalAction

Action that is implemented and performed outside of (your) third-party application. The application needs to redirect the business to the external location where they can perform the action.
builtin_user_input_action

BuiltInUserInputAction

Action implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business as specified for given action. They can trigger the action only when they provided all required inputs.

Reason

A single reason why the action is not available.

Fields
message

string

Messages summarizing the reason, why the action is not available. For example: "Review requested on Jan 03. Review requests can take a few days to complete."
detail

string

Detailed explanation of the reason. Should be displayed as a hint if present.
action

Action

Optional. An action that needs to be performed to solve the problem represented by this reason. This action will always be available. Should be rendered as a link or button next to the summarizing message.

For example, the review may be available only once the business configure all required attributes. In such a situation this action can be a link to the form, where they can fill the missing attribute to unblock the main action.

ActionFlow

Flow that can be selected for an action. When a business selects a flow, application should open a dialog with more information and input form.

Fields
id

string

Not for display but need to be sent back for the selected action flow.
label

string

Text value describing the intent for the action flow. It can be used as an input label if business needs to pick one of multiple flows. For example: "I disagree with the issue"
inputs[]

InputField

A list of input fields.
dialog_title

string

Title of the request dialog. For example: "Before you request a review"
dialog_button_label

string

Label for the button to trigger the action from the action dialog. For example: "Request review"
dialog_message

TextWithTooltip

Message displayed in the request dialog. For example: "Make sure you've fixed all your country-specific issues. If not, you may have to wait 7 days to request another review". There may be an more information to be shown in a tooltip.
dialog_callout

Callout

Important message to be highlighted in the request dialog. For example: "You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait a few days before you can request another review."

ActionInput

Input provided by the business.

Fields
action_flow_id

string

Required. Id of the selected action flow.
input_values[]

InputValue

Required. Values for input fields.

AggregateProductStatus

Aggregate product statuses for a given reporting context and country.

Fields
name

string

Identifier. The name of the AggregateProductStatuses resource. Format: accounts/{account}/aggregateProductStatuses/{aggregateProductStatuses}
reporting_context

ReportingContextEnum

The reporting context of the aggregate product statuses.
country

string

The country of the aggregate product statuses. Represented as a CLDR territory code.
stats

Stats

Products statistics for the given reporting context and country.
item_level_issues[]

ItemLevelIssue

The product issues that affect the given reporting context and country.

ItemLevelIssue

The ItemLevelIssue of the product status.

Fields
code

string

The error code of the issue.
severity

Severity

How this issue affects serving of the offer.
resolution

Resolution

Whether the issue can be resolved by the merchant.
attribute

string

The attribute's name, if the issue is caused by a single attribute.
description

string

A short issue description in English.
detail

string

A detailed issue description in English.
documentation_uri

string

The URL of a web page to help with resolving this issue.
product_count

int64

The number of products affected by this issue.

Resolution

How the issue can be resolved.

Enums
RESOLUTION_UNSPECIFIED Not specified.
MERCHANT_ACTION The issue can be resolved by the merchant.
PENDING_PROCESSING The issue will be resolved auomatically.

Severity

How the issue affects the serving of the product.

Enums
SEVERITY_UNSPECIFIED Not specified.
NOT_IMPACTED This issue represents a warning and does not have a direct affect on the product.
DEMOTED The product is demoted and most likely have limited performance in search results
DISAPPROVED Issue disapproves the product.

Stats

Products statistics.

Fields
active_count

int64

The number of products that are active.
pending_count

int64

The number of products that are pending.
disapproved_count

int64

The number of products that are disapproved.
expiring_count

int64

The number of products that are expiring.

Breakdown

A detailed impact breakdown for a group of regions where the impact of the issue on different shopping destinations is the same.

Fields
regions[]

Region

Lists of regions. Should be rendered as a title for this group of details. The full list should be shown to the business. If the list is too long, it is recommended to make it expandable.
details[]

string

Human readable, localized description of issue's effect on different targets. Should be rendered as a list.

For example:

  • "Products not showing in ads"
  • "Products not showing organically"

Region

Region with code and localized name.

Fields
code

string

The CLDR territory code
name

string

The localized name of the region. For region with code='001' the value is 'All countries' or the equivalent in other languages.

BuiltInSimpleAction

Action that is implemented and performed in (your) third-party application. Represents various functionality that is expected to be available to business and will help them with resolving the issue. The application should point the business to the place, where they can access the corresponding functionality. If the functionality is not supported, it is recommended to explain the situation to the business and provide them with instructions how to solve the issue.

Fields
type

BuiltInSimpleActionType

The type of action that represents a functionality that is expected to be available in third-party application.
attribute_code

string

The attribute that needs to be updated. Present when the type is EDIT_ITEM_ATTRIBUTE.

This field contains a code for attribute, represented in snake_case. You can find a list of product's attributes, with their codes here.
additional_content

AdditionalContent

Long text from an external source that should be available to the business. Present when the type is SHOW_ADDITIONAL_CONTENT.

AdditionalContent

Long text from external source.

Fields
title

string

Title of the additional content;
paragraphs[]

string

Long text organized into paragraphs.

BuiltInSimpleActionType

Enum specifying the type of action in third-party application.

Enums
BUILT_IN_SIMPLE_ACTION_TYPE_UNSPECIFIED Default value. Will never be provided by the API.
VERIFY_PHONE Redirect the business to the part of your application where they can verify their phone.
CLAIM_WEBSITE Redirect the business to the part of your application where they can claim their website.
ADD_PRODUCTS Redirect the business to the part of your application where they can add products.
ADD_CONTACT_INFO Open a form where the business can edit their contact information.
ADD_BUSINESS_REGISTRATION_NUMBER Open a form where the business can add their business registration number.
EDIT_ITEM_ATTRIBUTE Open a form where the business can edit an attribute. The attribute that needs to be updated is specified in attribute_code field of the action.
FIX_ACCOUNT_ISSUE

Redirect the business from the product issues to the diagnostic page with their account issues in your application.

This action will be returned only for product issues that are caused by an account issue and thus the business should resolve the problem on the account level.
SHOW_ADDITIONAL_CONTENT

Show additional content to the business.

This action will be used for example to deliver a justification from national authority.

BuiltInUserInputAction

Action that is implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the business. They can start the action only when they provided all required inputs. The application will request processing of the action by calling the triggeraction method.

Fields
action_context

string

Contains the action's context that must be included as part of the TriggerActionPayload.action_context in TriggerActionRequest.payload to call the triggeraction method. The content should be treated as opaque and must not be modified.
flows[]

ActionFlow

Actions may provide multiple different flows. Business selects one that fits best to their intent. Selecting the flow is the first step in user's interaction with the action. It affects what input fields will be available and required and also how the request will be processed.

Callout

An important message that should be highlighted. Usually displayed as a banner.

Fields
style_hint

CalloutStyleHint

Can be used to render messages with different severity in different styles. Snippets off all types contain important information that should be displayed to the business.
full_message

TextWithTooltip

A full message that needs to be shown to the business.

CalloutStyleHint

Enum specifying the suggested style, how the message should be rendered.

Enums
CALLOUT_STYLE_HINT_UNSPECIFIED Default value. Will never be provided by the API.
ERROR The most important type of information highlighting problems, like an unsuccessful outcome of previously requested actions.
WARNING Information warning about pending problems, risks or deadlines.
INFO Default severity for important information like pending status of previously requested action or cooldown for re-review.

ContentOption

Enum specifying how is the content returned.

Enums
CONTENT_OPTION_UNSPECIFIED Default value. Will never be provided by the API.
PRE_RENDERED_HTML Returns the detail of the issue as a pre-rendered HTML text.

ExternalAction

Action that is implemented and performed outside of the third-party application. It should redirect the business to the provided URL of an external system where they can perform the action. For example to request a review in the Merchant Center.

Fields
type

ExternalActionType

The type of external action.
uri

string

URL to external system, for example Merchant Center, where the business can perform the action.

ExternalActionType

Enum specifying the type of action that requires to redirect the business to an external location.

Enums
EXTERNAL_ACTION_TYPE_UNSPECIFIED Default value. Will never be provided by the API.
REVIEW_PRODUCT_ISSUE_IN_MERCHANT_CENTER Redirect to Merchant Center where the business can request a review for issue related to their product.
REVIEW_ACCOUNT_ISSUE_IN_MERCHANT_CENTER Redirect to Merchant Center where the business can request a review for issue related to their account.
LEGAL_APPEAL_IN_HELP_CENTER Redirect to the form in Help Center where the business can request a legal appeal for the issue.
VERIFY_IDENTITY_IN_MERCHANT_CENTER Redirect to Merchant Center where the business can perform identity verification.

Impact

Overall impact of the issue.

Fields
message

string

Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the business. For example: "Disapproves 90k offers in 25 countries"
severity

Severity

The severity of the issue.
breakdowns[]

Breakdown

Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the business. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.

InputField

Input field that needs to be available to the business. If the field is marked as required, then a value needs to be provided for a successful processing of the request.

Fields
id

string

Not for display but need to be sent back for the given input field.
label

TextWithTooltip

Input field label. There may be more information to be shown in a tooltip.
required

bool

Whether the field is required. The action button needs to stay disabled till values for all required fields are provided.
Union field value_input. Specific type of the input field. value_input can be only one of the following:
text_input

TextInput

Input field to provide text information. Corresponds to the html input type=text or html textarea.
choice_input

ChoiceInput

Input field to select one of the offered choices. Corresponds to the html input type=radio.
checkbox_input

CheckboxInput

Input field to provide a boolean value. Corresponds to the html input type=checkbox.

CheckboxInput

This type has no fields.

Checkbox input allows the business to provide a boolean value. Corresponds to the html input type=checkbox.

If the business checks the box, the input value for the field is true, otherwise it is false.

This type of input is often used as a confirmation that the business completed required steps before they are allowed to start the action. In such a case, the input field is marked as required and the button to trigger the action should stay disabled until the business checks the box.

ChoiceInput

Choice input allows the business to select one of the offered choices. Some choices may be linked to additional input fields that should be displayed under or next to the choice option. The value for the additional input field needs to be provided only when the specific choice is selected by the the business. For example, additional input field can be hidden or disabled until the business selects the specific choice.

Fields
options[]

ChoiceInputOption

A list of choices. Only one option can be selected.

ChoiceInputOption

A choice that the business can select.

Fields
id

string

Not for display but need to be sent back for the selected choice option.
label

TextWithTooltip

Short description of the choice option. There may be more information to be shown as a tooltip.
additional_input

InputField

Input that should be displayed when this option is selected. The additional input will not contain a ChoiceInput.

TextInput

Text input allows the business to provide a text value.

Fields
type

TextInputType

Type of the text input
additional_info

TextWithTooltip

Additional info regarding the field to be displayed to the business. For example, warning to not include personal identifiable information. There may be more information to be shown in a tooltip.
format_info

string

Information about the required format. If present, it should be shown close to the input field to help the business to provide a correct value. For example: "VAT numbers should be in a format similar to SK9999999999"
aria_label

string

Text to be used as the aria-label for the input.

TextInputType

Enum specifying the type of the text input and how it should be rendered.

Enums
TEXT_INPUT_TYPE_UNSPECIFIED Default value. Will never be provided by the API.
GENERIC_SHORT_TEXT Used when a short text is expected. The field can be rendered as a text field.
GENERIC_LONG_TEXT Used when a longer text is expected. The field should be rendered as a textarea.

InputValue

Input provided by the business for input field.

Fields
input_field_id

string

Required. Id of the corresponding input field.
Union field value. Value provided by the business. value can be only one of the following:
text_input_value

TextInputValue

Value for text input field.
choice_input_value

ChoiceInputValue

Value for choice input field.
checkbox_input_value

CheckboxInputValue

Value for checkbox input field.

CheckboxInputValue

Value for checkbox input field.

Fields
value

bool

Required. True if the business checked the box field. False otherwise.

ChoiceInputValue

Value for choice input field.

Fields
choice_input_option_id

string

Required. [Id][InputField.ChoiceInput.id] of the option that was selected by the business.

TextInputValue

Value for text input field.

Fields
value

string

Required. Text provided by the business.

ListAggregateProductStatusesRequest

Request message for the ListAggregateProductStatuses method.

Fields
parent

string

Required. The account to list aggregate product statuses for. Format: accounts/{account}
page_size

int32

Optional. The maximum number of aggregate product statuses to return. The service may return fewer than this value. If unspecified, at most 25 aggregate product statuses are returned. The maximum value is 250; values above 250 are coerced to 250.
page_token

string

Optional. A page token, received from a previous ListAggregateProductStatuses call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListAggregateProductStatuses must match the call that provided the page token.
filter

string

Optional. A filter expression that filters the aggregate product statuses. Filtering is only supported by the reporting_context and country field. For example: reporting_context = "SHOPPING_ADS" AND country = "US".

ListAggregateProductStatusesResponse

Response message for the ListAggregateProductStatuses method.

Fields
aggregate_product_statuses[]

AggregateProductStatus

The AggregateProductStatuses resources for the given account.
next_page_token

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

RenderAccountIssuesRequest

Request to provide issue resolution content and actions for business's account issues.

Fields
name

string

Required. The account to fetch issues for. Format: accounts/{account}
language_code

string

Optional. The IETF BCP-47 language code used to localize issue resolution content. If not set, the result will be in default language en-US.
time_zone

string

Optional. The IANA timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.
payload

RenderIssuesRequestPayload

Optional. The payload for configuring how the content should be rendered.

RenderAccountIssuesResponse

Response containing an issue resolution content and actions for listed account issues.

Fields
rendered_issues[]

RenderedIssue

List of account issues for a given account.

This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.

RenderIssuesRequestPayload

The payload for configuring how the content should be rendered.

Fields
content_option

ContentOption

Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.
user_input_action_option

UserInputActionRenderingOption

Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points the business to Merchant Center where they can request the action.

RenderProductIssuesRequest

Request to provide an issue resolution content and actions for product issues of business's product.

Fields
name

string

Required. The name of the product to fetch issues for. Format: accounts/{account}/products/{product}
language_code

string

Optional. The IETF BCP-47 language code used to localize an issue resolution content. If not set, the result will be in default language en-US.
time_zone

string

Optional. The IANA timezone used to localize times in an issue resolution content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.
payload

RenderIssuesRequestPayload

Optional. The payload for configuring how the content should be rendered.

RenderProductIssuesResponse

Response containing an issue resolution content and actions for listed product issues.

Fields
rendered_issues[]

RenderedIssue

List of issues for a given product.

This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.

RenderedIssue

An issue affecting specific business or their product.

Fields
title

string

Title of the issue.
impact

Impact

Clarifies the severity of the issue.

The summarizing message, if present, should be shown right under the title for each issue. It helps business to quickly understand the impact of the issue.

The detailed breakdown helps the business to fully understand the impact of the issue. It can be rendered as dialog that opens when the business mouse over the summarized impact statement.

Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between ERROR, WARNING and INFO.
actions[]

Action

A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when business disagrees with the issue.

Actions that are supported in (your) third-party application can be rendered as buttons and should be available to the business when they expand the issue.
Union field content. Detailed content of the issue. Should be shown to the business when they expand the issue. The form in which is the content returned is specified with the content option request field. content can be only one of the following:
prerendered_content

string

Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content.

Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: div, span, p, a, ul, li, table, tr, td. For example, you can use DOMPurify.

CSS classes:

  • issue-detail - top level container for the detail of the issue
  • callout-banners - section of the issue-detail with callout banners
  • callout-banner - single callout banner, inside callout-banners
  • callout-banner-info - callout with important information (default)
  • callout-banner-warning - callout with a warning
  • callout-banner-error - callout informing about an error (most severe)
  • issue-content - section of the issue-detail, contains multiple content-element
  • content-element - content element such as a list, link or paragraph, inside issue-content
  • root-causes - unordered list with items describing root causes of the issue, inside issue-content
  • root-causes-intro - intro text before the root-causes list, inside issue-content
  • segment - section of the text, span inside paragraph
  • segment-attribute - section of the text that represents a product attribute, for example 'image_link'
  • segment-literal - section of the text that contains a special value, for example '0-1000 kg'
  • segment-bold - section of the text that should be rendered as bold
  • segment-italic - section of the text that should be rendered as italic
  • tooltip - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class tooltip-text and is intended to be shown in a mouse over dialog. If the style is not used, the tooltip-text section would be shown on a new line, after the main part of the text.
  • tooltip-text - marks a section of the text within a tooltip, that is intended to be shown in a mouse over dialog.
  • tooltip-icon - marks a section of the text within a tooltip, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a br tag, that is separating the main text and the tooltip text when the style is not used.
  • tooltip-style-question - the tooltip shows helpful information, can use the '?' as an icon.
  • tooltip-style-info - the tooltip adds additional information fitting to the context, can use the 'i' as an icon.
  • content-moderation - marks the paragraph that explains how the issue was identified.
  • new-element - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.

Union field out_of_court_dispute_settlement. Out-of-court dispute settlement (ODS) contains a link to a page where the business can bring their appeal to an external body. It may contains a detailed instructions and any values needed for the business to proceed with their request.

The ODS is a part of the EU's Digital Service ACT (DSA). If present, it should be shown to the business.

The ODS may differ for individual issues and thus it should be by default shown in the detail of the issue. It could be shown next to actions for the issue.

In some cases the ODS could be the same for all issues in the list. If the values for individual issues do not differ, then the ODS could be shown only once. For example under the list with issues. This is an optional UX improvement. If values differ, then ODS needs to be shown in details of individual issues. out_of_court_dispute_settlement can be only one of the following:
prerendered_out_of_court_dispute_settlement

string

Pre-rendered HTML that contains a link to the external location where the ODS can be requested and instructions for how to request it. HTML elements contain CSS classes that can be used to customize the style of this snippet.

Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: div, span, p, a, ul, li, table, tr, td. For example, you can use DOMPurify.

CSS classes:

  • ods-section* - wrapper around the out-of-court dispute resolution section
  • ods-description* - intro text for the out-of-court dispute resolution. It may contain multiple segments and a link.
  • ods-param* - wrapper around the header-value pair for parameters that the business may need to provide during the ODS process.
  • ods-routing-id* - ods param for the Routing ID.
  • ods-reference-id* - ods param for the Routing ID.
  • ods-param-header* - header for the ODS parameter
  • ods-param-value* - value of the ODS parameter. This value should be rendered in a way that it is easy for the user to identify and copy.
  • segment - section of the text, span inside paragraph
  • segment-attribute - section of the text that represents a product attribute, for example 'image_link'
  • segment-literal - section of the text that contains a special value, for example '0-1000 kg'
  • segment-bold - section of the text that should be rendered as bold
  • segment-italic - section of the text that should be rendered as italic
  • tooltip - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class tooltip-text and is intended to be shown in a mouse over dialog. If the style is not used, the tooltip-text section would be shown on a new line, after the main part of the text.
  • tooltip-text - marks a section of the text within a tooltip, that is intended to be shown in a mouse over dialog.
  • tooltip-icon - marks a section of the text within a tooltip, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a br tag, that is separating the main text and the tooltip text when the style is not used.
  • tooltip-style-question - the tooltip shows helpful information, can use the '?' as an icon.
  • tooltip-style-info - the tooltip adds additional information fitting to the context, can use the 'i' as an icon.

Severity

Enum specifying the severity of the issue.

Enums
SEVERITY_UNSPECIFIED Default value. Will never be provided by the API.
ERROR Causes either an account suspension or an item disapproval. Errors should be resolved as soon as possible to ensure items are eligible to appear in results again.
WARNING Warnings can negatively impact the performance of ads and can lead to item or account suspensions in the future unless the issue is resolved.
INFO Infos are suggested optimizations to increase data quality. Resolving these issues is recommended, but not required.

TextWithTooltip

Block of text that may contain a tooltip with more information.

Fields
tooltip_icon_style

TooltipIconStyle

The suggested type of an icon for tooltip, if a tooltip is present.
Union field value. Value of the text message. The form in which the value is returned is specified with the content option request field. value can be only one of the following:
simple_value

string

Value of the message as a simple text.
Union field tooltip_value. Text that is meant to be shown in a tooltip for the main message. The tooltip is present when there is additional content needed to be available to the business. The form in which the value is returned is specified with the content option request field. tooltip_value can be only one of the following:
simple_tooltip_value

string

Value of the tooltip as a simple text.

TooltipIconStyle

Enum specifying the type of an icon that is being used to display a corresponding tooltip in the Merchant Center.

Enums
TOOLTIP_ICON_STYLE_UNSPECIFIED Default value. Will never be provided by the API.
INFO Used when the tooltip adds additional information to the context, the 'i' can be used as an icon.
QUESTION Used when the tooltip shows helpful information, the '?' can be used as an icon.

TriggerActionPayload

The payload for the triggered action.

Fields
action_context

string

Required. The context from the selected action. The value is obtained from rendered issues and needs to be sent back to identify the action that is being triggered.
action_input

ActionInput

Required. Input provided by the business.

TriggerActionRequest

Request to start the selected action

Fields
name

string

Required. The business's account that is triggering the action. Format: accounts/{account}
payload

TriggerActionPayload

Required. The payload for the triggered action.
language_code

string

Optional. Language code IETF BCP 47 syntax used to localize the response. If not set, the result will be in default language en-US.

TriggerActionResponse

Response informing about the started action.

Fields
message

string

The message for the business.

UserInputActionRenderingOption

Enum specifying how actions with user input forms, such as requesting re-review, are handled.

Enums
USER_INPUT_ACTION_RENDERING_OPTION_UNSPECIFIED Default value. Will never be provided by the API.
REDIRECT_TO_MERCHANT_CENTER Actions that require user input are represented only as links that points the business to Merchant Center where they can request the action. Provides easier to implement alternative to BUILT_IN_USER_INPUT_ACTIONS.
BUILT_IN_USER_INPUT_ACTIONS Returns content and input form definition for each complex action. Your application needs to display this content and input form to the business before they can request processing of the action. To start the action, your application needs to call the triggeraction method.