Namespace Google.Apis.Merchant.accounts_v1beta.Data
Classes
AcceptTermsOfServiceResponse
Response message for the AcceptTermsOfService
method.
Accepted
Describes the accepted terms of service.
Account
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
.
AccountManagement
AccountManagement
payload.
AccountRelationship
The AccountRelationship
message defines a formal connection between a merchant's account and a service
provider's account. This relationship enables the provider to offer specific services to the merchant, such as
product management or campaign management. It specifies the access rights and permissions to the merchant's data
relevant to those services. Establishing an account relationship involves linking the merchant's account with a
provider's account. The provider could be another Google account (like Google Ads or Google My Business) or a
third-party platform (such as Shopify or WooCommerce).
AccountService
The AccountService
message represents a specific service that a provider account offers to a merchant account.
AccountService
defines the permissions and capabilities granted to the provider, allowing for operations such
as product management or campaign management. The lifecycle of an AccountService
involves a proposal phase,
where one party suggests the service, and an approval phase, where the other party accepts or rejects it. This
handshake mechanism ensures mutual consent before any access is granted. This mechanism safeguards both parties
by ensuring that access rights are granted appropriately and that both the merchant and provider are aware of
the services enabled. In scenarios where a user is an admin of both accounts, the approval can happen
automatically. The mutability of a service is also managed through AccountService
. Some services might be
immutable, for example, if they were established through other systems or APIs, and you cannot alter them
through this API.
AddAccountService
Additional instructions to add account services during creation of the account.
AddUser
Instruction for adding a user to the account during creation.
Address
Shipping address of the warehouse.
ApproveAccountServiceRequest
Request to approve an account service.
AutofeedSettings
Collection of information related to the autofeed settings.
AutomaticImageImprovements
This improvement will attempt to automatically correct submitted images if they don't meet the image requirements, for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: Automatic image improvements
AutomaticImprovements
Collection of information related to the automatic improvements of an account.
AutomaticItemUpdates
Turning on item updates allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.
AutomaticShippingImprovements
Not available for MCAs accounts. By turning on automatic shipping improvements, you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data
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.
CampaignsManagement
CampaignManagement
payload.
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?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.
Handshake
The current status of establishing of the service. (for example, pending approval or approved).
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.
ImageImprovementsAccountLevelSettings
Settings for the Automatic Image Improvements.
Impact
The impact of the issue on a region.
ImpactedDestination
The impact of the issue on a destination.
ItemUpdatesAccountLevelSettings
Settings for the Automatic Item Updates.
ListAccountIssuesResponse
Response message for the ListAccountIssues
method.
ListAccountRelationshipsResponse
Response after trying to list account relationships.
ListAccountServicesResponse
Response after trying to list account services.
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 (for example, 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 by user input or from importing existing data, depending on the type of process. Advice on address input or 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, 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
ProductsManagement
ProductsManagement
payload.
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. The following list is the available set of program resource
IDs accessible through the API: * free-listings
* shopping-ads
* youtube-shopping-checkout
ProposeAccountServiceRequest
Request to propose an account service.
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.
RejectAccountServiceRequest
Request to reject an account service.
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.
SeasonalOverride
Service
Shipping service.
ShippingSettings
The merchant account's shipping settings.
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 (For example "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 (For example: 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. For more information, see Terms of
Service. 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
.
TransitTimeValue
Transit time range (min-max) in business days.
UnclaimHomepageRequest
Request message for the UnclaimHomepage
method.
User
The User
message represents a user associated with a Merchant Center account. It is used to manage user
permissions and access rights within the account. For more information, see Frequently asked questions about
people and access levels.
Value
The single value of a rate group or the value of a rate group table's cell. Exactly one of no_shipping
,
flat_rate
, price_percentage
, carrier_rateName
, subtable_name
must be set.
Warehouse
A fulfillment warehouse, which stores and handles inventory.
WarehouseBasedDeliveryTime
Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the
settings of the selected carrier. When set, no other transit time related field in delivery_time
should be
set.
WarehouseCutoffTime
The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.
Weight
The weight represented as the value in string and the unit.