Namespace Google.Apis.Merchant.accounts_v1beta.Data

Classes

Accepted

Describes the accepted terms of service.

The Account message represents a merchant's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a multi-client account (MCA) structure. In an MCA setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The Account message is the parent entity for many other resources, for example, AccountRelationship, Homepage, BusinessInfo and so on.

AccountAggregation

AccountAggregation payload.

AccountIssue

An AccountIssue.

AddAccountService

Additional instructions to add account services during creation of the account.

Address

Shipping address of the warehouse.

AutofeedSettings

Collection of information related to the autofeed settings.

BusinessDayConfig

Business days of the warehouse.

BusinessIdentity

Collection of information related to the identity of a business.

BusinessInfo

The BusinessInfo message contains essential information about a merchant's business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.

CarrierRate

A list of carrier rates that can be referred to by main_table or single_value. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

ClaimHomepageRequest

Request message for the ClaimHomepage method.

CreateAndConfigureAccountRequest

Request message for the CreateAndConfigureAccount method.

CreateUserRequest

Request message for the CreateUser method.

CustomerService

Customer service information.

CutoffConfig

Configs related to local delivery ends for the day.

CutoffTime

Business days cutoff time definition.

Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

DeliveryTime

Time spent in various aspects from order to the delivery of the product.

DisableProgramRequest

Request message for the DisableProgram method.

Distance

Maximum delivery radius. This is only required for the local delivery shipment type.

EmailPreferences

The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.

Empty

A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

EnableProgramRequest

Request message for the EnableProgram method.

GeoTargetArea

A list of geotargets that defines the region area.

Headers

A non-empty list of row or column headers for a table. Exactly one of prices, weights, num_items, postal_code_group_names, or location must be set.

Homepage

The Homepage message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see Understanding online store URL verification.

IdentityAttribute

All information related to an identity attribute.

Impact

The impact of the issue on a region.

ImpactedDestination

The impact of the issue on a destination.

ListAccountIssuesResponse

Response message for the ListAccountIssues method.

ListAccountsResponse

Response message for the ListAccounts method.

ListOnlineReturnPoliciesResponse

Response message for the ListOnlineReturnPolicies method.

ListProgramsResponse

Response message for the ListPrograms method.

ListRegionsResponse

Response message for the ListRegions method.

ListSubAccountsResponse

Response message for the ListSubAccounts method.

ListUsersResponse

Response message for the ListUsers method.

LocalCutoffTime

Time that local delivery ends for the day.

LocationIdSet

A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.

LoyaltyProgram

Loyalty program provided by a merchant.

LoyaltyProgramTiers

Subset of a merchants loyalty program.

MinimumOrderValueTable

Table of per store minimum order values for the pickup fulfillment type.

OnlineReturnPolicy

Online return policy object. This is currently used to represent return policies for ads and free listings programs.

PhoneNumber

An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an i18n.phonenumbers.PhoneNumber object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); } Reference(s): - https://github.com/google/libphonenumber

Policy

The available policies.

PostalAddress

Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478

PostalCodeArea

A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible through the account's ShippingSettings.postalCodeGroups resource.

PostalCodeRange

A range of postal codes that defines the region area.

Price

The price represented as a number and currency.

ProductChange

The change that happened to the product including old value, new value, country code as the region code and reporting context.

ProductStatusChangeMessage

The message that the merchant will receive to notify about product status change event

Program

Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the Free product listings program, which enables products from a merchant's store to be shown across Google for free.

RateGroup

Shipping rate group definitions. Only the last one is allowed to have an empty applicable_shipping_labels, which means "everything else". The other applicable_shipping_labels must not overlap.

Region

Represents a geographic region that you can use as a target with both the RegionalInventory and ShippingSettings services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets. For more information, see Set up regions for more information.

Required

Describes the terms of service which are required to be accepted.

Requirement

Defines a requirement specified for participation in the program.

RestockingFee

The restocking fee. This can be a flat fee or a micro percent.

ReturnShippingFee

The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost.

Row

Include a list of cells.

Service

Shipping service.

ShippingSettings

The merchant account's shipping setting.

ShortCode

An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (e.g. "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (e.g. US and CA).

StoreCodeSetWithMov

A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.

StoreConfig

A list of stores your products are delivered from. This is only valid for the local delivery shipment type.

Table

A table defining the rate group, when single_value is not expressive enough.

TermsOfService

The TermsOfService message represents a specific version of the terms of service that merchants must accept to access certain features or services (see https://support.google.com/merchants/answer/160173). This message is important for the onboarding process, ensuring that merchants agree to the necessary legal agreements for using the service. Merchants can retrieve the latest terms of service for a given kind and region through RetrieveLatestTermsOfService, and accept them as required through AcceptTermsOfService.

TermsOfServiceAgreementState

This resource represents the agreement state for a given account and terms of service kind. The state is as follows: * If the merchant has accepted a terms of service: accepted will be populated, otherwise it will be empty * If the merchant must sign a terms of service: required will be populated, otherwise it will be empty. Note that both required and accepted can be present. In this case the accepted terms of services will have an expiration date set in the valid_until field. The required terms of services need to be accepted before valid_until in order for the account to continue having a valid agreement. When accepting new terms of services we expect 3Ps to display the text associated with the given terms of service agreement (the url to the file containing the text is added in the Required message below as tos_file_uri. The actual acceptance of the terms of service is done by calling accept on the TermsOfService resource.

TimeZone

Represents a time zone from the IANA Time Zone Database.

TransitTable

Transit time table, number of business days spent in transit based on row and column dimensions. Either min_transit_days, max_transit_days or transit_time_table can be set, but not both.

TransitTimeRow

If there's only one dimension set of postal_code_group_names or transit_time_labels, there are multiple rows each with one value for that dimension. If there are two dimensions, each row corresponds to a postal_code_group_names, and columns (values) to a transit_time_labels.