Namespace Google.Apis.Merchant.accounts_v1beta.Data
Classes
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
.
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
Collection of information related to a business.
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
A store's homepage.
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
.
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.