Package google.shopping.merchant.accounts.v1beta

Dizin

AccountIssueService

AccountIssueService API'yi destekleyen hizmet.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Bir Merchant Center hesabının tüm hesap sorunlarını listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

AccountsService

Accounts API'yi destekleyen hizmet.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Ek yapılandırma içeren bağımsız bir Merchant Center hesabı oluşturur. İsteği yapan kullanıcıyı yeni hesabın yöneticisi olarak ekler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Belirtilen hesabı türüne bakılmaksızın (bağımsız, MCA veya alt hesap) siler. Bir MCA'nın silinmesi, tüm alt hesaplarının da silinmesine neden olur. Bu yöntemin yürütülmesi için yönetici erişimi gerekir. Silme işlemi yalnızca hesabın başka bir hesaba hizmet vermemesi ve işlenen teklifi olmaması durumunda başarılı olur. Bunu geçersiz kılmak için force parametresini kullanabilirsiniz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Merchant Center hesabınızdan bir hesap alır. Bir hesap ekledikten, güncelledikten veya sildikten sonra değişikliklerin geçerli olması birkaç dakikayı bulabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Arayan kullanıcının erişebildiği ve sayfa boyutu veya filtreler gibi istek kısıtlamalarıyla eşleşen hesapları listeler. Bu listede yalnızca bir MCA'nın alt hesapları değil, arayan kullanıcının erişebildiği diğer MCA'lar, bağlı hesaplar, bağımsız hesaplar vb. tüm hesaplar listelenir. Filtre sağlanmazsa kullanıcının doğrudan eklendiği hesapları döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Belirli bir çok müşterili hesabın tüm alt hesaplarını listeleyin. Bu, daha güçlü ListAccounts yöntemi için kolaylık sağlayan bir sarmalayıcıdır. Bu yöntem, ListsAccounts işlevinin aşağıdaki filtreyle çağrılmasıyla aynı sonuçları verir: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Hesabın türüne (bağımsız, MCA veya alt hesap) bakılmaksızın hesabı günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

AutofeedSettingsService

Otomatik feed ayarını destekleyen hizmet.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Bir hesabın otomatik feed ayarlarını alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Hesabın otomatik feed ayarlarını günceller.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

BusinessIdentityService

İşletme kimliği API'sini destekleyen hizmet.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Bir hesabın işletme kimliğini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Hesabın işletme kimliğini günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

BusinessInfoService

İşletme bilgileri API'sini destekleyen hizmet.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Bir hesabın işletme bilgilerini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Bir hesabın işletme bilgilerini günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

EmailPreferencesService

EmailPreferences API'yi destekleyen hizmet.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Merchant Center hesabı kullanıcısının e-posta tercihlerini döndürür. Bu hizmet yalnızca kimliği doğrulanmış kullanıcının e-posta tercihlerinin alınmasına ve güncellenmesine izin verir. Kimliği doğrulanmış kullanıcının tercihlerini almak için name=accounts/*/users/me/emailPreferences takma adını kullanın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Merchant Center hesabı kullanıcısının e-posta tercihlerini günceller. MCA kullanıcıları, MCA'nın bir alt hesabı yerine MCA hesabını belirtmelidir.

Güncelleme maskesinde açıkça seçilmeyen tercihler güncellenmez.

Güncellemelerde UNCONFIRMED (ONAYLANMAMIŞ) etkinleştirme durumu değeri belirtilmesi geçersizdir.

Kimliği doğrulanmış kullanıcının tercihlerini güncellemek için name=accounts/*/users/me/emailPreferences takma adını kullanın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

HomepageService

Mağazanın ana sayfası için API'yi destekleyen hizmet.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Mağazanın ana sayfası için hak talebinde bulunur. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Ana sayfa için hak talebinde bulunulmuşsa doğrulama işlemi yeniden kontrol edilir (satıcı hak talebinde bulunmadan muaf tutulmadığı sürece doğrulamadan muaf tutulmaz) ve başarılı bir yanıt döndürülür. Sahiplik artık doğrulanamıyorsa hata döndürülür ancak hak talebi kaldırılmaz. Başarısızlık durumunda standart bir hata mesajı döndürülür: * PERMISSION_DENIED: Kullanıcının bu Merchant Center hesabında gerekli izinleri yoktur; * FAILED_PRECONDITION: - Hesap bir Merchant Center hesabı değildir; - Merchant Center hesabının ana sayfası yoktur; - Hak talebi başarısız oldu (bu durumda hata mesajı daha fazla ayrıntı içerir).

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Bir mağazanın ana sayfasını alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Mağazanın ana sayfası için hak talebini iptal eder. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Mağazanın ana sayfasını günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

OnlineReturnPolicyService

Bu hizmet, satıcının pişmanlık iade politikası yapılandırmasının yönetimini kolaylaştırır. Bu hizmet hem reklamlar hem de ücretsiz listelemeler için iade politikalarını kapsar.

programları kullanabilirsiniz. Bu API aşağıdaki kaynak modelini tanımlar:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Belirli bir satıcının mevcut iade politikasını alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Belirli bir satıcının mevcut tüm iade politikalarını listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ProgramsService

Program yönetimi hizmeti.

Programlar, satıcı hesaplarına işlev eklemek için bir mekanizma sağlar. Bunun tipik bir örneği, satıcının mağazasındaki ürünlerin Google'da ücretsiz olarak gösterilmesini sağlayan ücretsiz ürün listelemeleri programıdır.

Bu hizmet, satıcının mevcut tüm programlara katılımını alma yöntemlerinin yanı sıra her bir programa katılımı açıkça etkinleştirme veya devre dışı bırakma yöntemlerini de gösterir.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Hesap için belirtilen programa katılımı devre dışı bırakır. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Hesap için belirtilen programa katılımı etkinleştirin. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Hesap için belirtilen programı alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Hesabın tüm programlarını alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

RegionsService

Bölge yapılandırmasını yönetir.

Bu API aşağıdaki kaynak modelini tanımlar:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Merchant Center hesabınızda bir bölge tanımı oluşturur. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Merchant Center hesabınızdaki bir bölge tanımını siler. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Merchant Center hesabınızda tanımlanan bir bölgeyi alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Merchant Center hesabınızdaki bölgeleri listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Merchant Center hesabınızdaki bir bölge tanımını günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ShippingSettingsService

Merchant API yöntemi başına yöntem çağrısı kargo ayarı bilgilerini almak için kullanılan hizmet.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Kargo ayarı bilgilerini alma.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Satıcının kargo ayarını istek kargo ayarıyla değiştirin. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

TermsOfServiceAgreementStateService

TermsOfServiceAgreementState API'yi destekleyen hizmet.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Hizmet Şartları sözleşmesinin durumunu döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Uygulamanın hizmet şartları sözleşmesinin durumunu alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

TermsOfServiceService

TermsOfService API'yi destekleyen hizmet.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

TermsOfService kabul eder. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Sağlanan sürümle ilişkili TermsOfService öğesini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Belirli bir kind ve region_code için TermsOfService'ın en son sürümünü alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UserService

Kullanıcı API'sini destekleyen hizmet.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Merchant Center hesabı kullanıcısı oluşturur. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Merchant Center hesabı kullanıcısını siler. Bu yöntemin yürütülmesi için yönetici erişimi gerekir. Sililecek kullanıcı, ilgili hesabın son yönetici kullanıcısı olamaz. Ayrıca, İşletme Yöneticisi tarafından yönetilen kullanıcılar silinmeye karşı korunur."

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

GetUser

rpc GetUser(GetUserRequest) returns (User)

Bir Merchant Center hesabı kullanıcısını alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Bir Merchant Center hesabının tüm kullanıcılarını listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Merchant Center hesabı kullanıcısını günceller. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

AcceptTermsOfServiceRequest

AcceptTermsOfService yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Hizmet Şartları sürümünün kaynak adı. Biçim: termsOfService/{version}

account

string

Zorunlu. Hizmet Şartları'nın kabul edileceği hesap.

region_code

string

Zorunlu. CLDR tarafından tanımlanan bölge kodu. Hükümler ve Koşullar belirli bir ülke için geçerliyse bu ülke, Hükümler ve Koşullar dünya genelinde geçerliyse 001 olur.

Kabul edildi

Kabul edilen hizmet şartlarını açıklar.

Alanlar
terms_of_service

string

Kabul edilen termsOfService.

accepted_by

string

Kabulün kaydedildiği hesap. Bu, hesabın kendisi veya alt hesaplar söz konusu olduğunda MCA hesabı olabilir.

valid_until

Date

Bu ayar, kabul edilen TermsOfService'nın yalnızca bu tarihin sonuna kadar (UTC'de) geçerli olduğunu belirtir. Bu tarihten önce yeni bir davetin kabul edilmesi gerekir. Gerekli TermsOfService bilgileri Zorunlu mesajında yer alır.

AccessRight

Erişim hakkı.

Sıralamalar
ACCESS_RIGHT_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
STANDARD Standart erişim hakları.
ADMIN Yönetici erişim hakları.
PERFORMANCE_REPORTING Bu hakka sahip kullanıcılar performans ve analizlere erişebilir.

Hesap

Account mesajı, satıcının Alışveriş reklamlarındaki hesabını temsil eder. Ürün verilerini, ayarları ve Google'ın hizmetleri ile harici sağlayıcılarla olan etkileşimleri yönetmek için birincil öğedir.

Hesaplar bağımsız varlıklar olarak çalışabilir veya çok müşterili hesap (MCA) yapısının bir parçası olabilir. MCA kurulumunda üst hesap birden fazla alt hesabı yönetir.

Hesap oluşturma işleminde hesap adı, saat dilimi ve dil tercihleri gibi özellikler yapılandırılır.

Account mesajı, AccountRelationship, Homepage, BusinessInfo vb. gibi diğer birçok kaynağın üst öğesidir.

Alanlar
name

string

Tanımlayıcı. Hesabın kaynak adı. Biçim: accounts/{account}

account_id

int64

Yalnızca çıkış. Hesabın kimliği.

account_name

string

Zorunlu. Hesabın, kullanıcılar tarafından okunabilen adı. Daha fazla bilgi için mağaza adı ve işletme adı bölümlerine bakın.

adult_content

bool

Hesabın yetişkinlere uygun içerik barındırıp barındırmadığı.

test_account

bool

Yalnızca çıkış. Hesabın test hesabı olup olmadığı.

time_zone

TimeZone

Zorunlu. Hesabın saat dilimi.

Yazma işlemlerinde time_zone hem reporting_time_zone hem de display_time_zone değerini ayarlar.

Okuma işlemleri için time_zone her zaman display_time_zone değerini döndürür. Hesabınızda display_time_zone yoksa time_zone boş olur.

language_code

string

Zorunlu. Hesabın BCP-47 dil kodu (ör. en-US veya sr-Latn).

AccountAggregation

Bu türde alan yoktur.

AccountAggregation yükünü gönderir.

AccountIssue

AccountIssue.

Alanlar
name

string

Tanımlayıcı. Hesap sorununun kaynak adı. Biçim: accounts/{account}/issues/{id}

title

string

Sorunun yerelleştirilmiş başlığı.

severity

Severity

Sorunun genel önem derecesi.

impacted_destinations[]

ImpactedDestination

Bu sorunun çeşitli hedefler üzerindeki etkisi.

detail

string

Sorunla ilgili yerelleştirilmiş diğer ayrıntılar.

documentation_uri

string

Sorun ve nasıl düzeltileceği hakkında daha fazla bilgi veren Merchant Center Yardım Merkezi bağlantısı.

ImpactedDestination

Sorunun hedef üzerindeki etkisi.

Alanlar
impacts[]

Impact

Belirtilen hedefteki çeşitli bölgeler için (negatif) etki.

reporting_context

ReportingContextEnum

Etkilenen raporlama bağlamı.

Etki

Sorunun bir bölge üzerindeki etkisi.

Alanlar
region_code

string

Bu sorunun geçerli olduğu CLDR bölge kodu.

severity

Severity

Sorunun hedef ve bölgedeki ciddiyeti.

Önem derecesi

Olası tüm sorun önem dereceleri.

Sıralamalar
SEVERITY_UNSPECIFIED Önem düzeyi bilinmiyor.
CRITICAL Sorun, tekliflerin yayınlanmamasına neden olur.
ERROR Sorun, teklifleri (gelecekte) etkileyebilir veya tekliflerle ilgili sorunların göstergesi olabilir.
SUGGESTION Sorun, iyileştirme önerisidir.

Adres

Deponun gönderim adresi.

Alanlar
street_address

string

Adresin sokak düzeyindeki kısmı. Örneğin: 111w 31st Street.

city

string

Zorunlu. Şehir, kasaba veya belediye. Bağlı yerel birimleri veya alt yerel birimleri de (ör. mahalleler veya banliyöler) içerebilir.

administrative_area

string

Zorunlu. Ülkenin üst düzey idari alt bölümü. Örneğin, Kaliforniya ("CA") gibi bir eyalet veya Quebec ("QC") gibi bir il.

postal_code

string

Zorunlu. Posta kodu (ör. "94043").

region_code

string

Zorunlu. CLDR ülke kodu (örneğin, "US").

AutofeedSettings

Otomatik feed ayarlarıyla ilgili bilgilerin toplanması.

Alanlar
name

string

Tanımlayıcı. Otomatik feed ayarlarının kaynak adı. Biçim: accounts/{account}/autofeedSettings.

enable_products

bool

Zorunlu. Belirtilen hesap için otomatik feed üzerinden ürün taramasını etkinleştirir veya devre dışı bırakır. Otomatik feed hesapları, eligible alanı üzerinden kontrol edilebilen belirli koşulları karşılamalıdır. Hesap bir pazar yeri olmamalıdır. Otomatik feed ilk kez etkinleştirildiğinde ürünler genellikle anında gösterilir. Yeniden etkinleştirildiğinde ürünlerin görünmesi 24 saati bulabilir.

eligible

bool

Yalnızca çıkış. Satıcının otomatik feed'e kaydolmaya uygun olup olmadığını belirler.

BusinessDayConfig

Deponun iş günleri.

Alanlar
business_days[]

Weekday

Zorunlu. Normal iş günleri. Boş olamaz.

Hafta içi

Sıralamalar
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Bir işletmenin kimliği ile ilgili bilgi koleksiyonu.

Alanlar
name

string

Tanımlayıcı. İşletme kimliğinin kaynak adı. Biçim: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

İsteğe bağlı. İşletmenin sahibinin siyahi olup olmadığını belirtir. Bu isteğe bağlı alan yalnızca işletme ülkesi US olarak ayarlanmış satıcılar tarafından kullanılabilir. Pazar yerleri veya pazar yeri satıcıları için de geçerli değildir.

women_owned

IdentityAttribute

İsteğe bağlı. İşletmenin sahibinin kadın olduğunu belirtir. Bu isteğe bağlı alan yalnızca işletme ülkesi US olarak ayarlanmış satıcılar tarafından kullanılabilir. Pazar yerleri veya pazar yeri satıcıları için de geçerli değildir.

veteran_owned

IdentityAttribute

İsteğe bağlı. İşletmenin, sahibi gazi olan işletme olarak tanımlanıp tanımlanmadığını belirtir. Bu isteğe bağlı alan yalnızca işletme ülkesi US olarak ayarlanmış satıcılar tarafından kullanılabilir. Pazar yerleri veya pazar yeri satıcıları için de geçerli değildir.

latino_owned

IdentityAttribute

İsteğe bağlı. İşletmenin sahibinin Latin olduğunu belirtir. Bu isteğe bağlı alan yalnızca işletme ülkesi US olarak ayarlanmış satıcılar tarafından kullanılabilir. Pazar yerleri veya pazar yeri satıcıları için de geçerli değildir.

small_business

IdentityAttribute

İsteğe bağlı. İşletmenin kendisini küçük işletme olarak tanımlayıp tanımlamadığını belirtir. Bu isteğe bağlı alan yalnızca işletme ülkesi US olarak ayarlanmış satıcılar tarafından kullanılabilir. Pazar yerleri için de geçerli değildir.

IdentityAttribute

Kimlik özelliğiyle ilgili tüm bilgiler.

Alanlar
identity_declaration

IdentityDeclaration

Zorunlu. Bu özelliğin kimlik beyanı.

IdentityDeclaration

Kimlik beyanı ile ilgili tüm ayarlar.

Sıralamalar
IDENTITY_DECLARATION_UNSPECIFIED Hiçbir seçim yapılmadığını belirten varsayılan değer.
SELF_IDENTIFIES_AS Hesabın özellikle ilişkili olduğunu gösterir.
DOES_NOT_SELF_IDENTIFY_AS Hesabın, özellikle ilişkili olmadığını gösterir.

PromotionsConsent

İşletme kimliğiyle ilgili promosyonlarla ilgili tüm ayarlar.

Sıralamalar

BusinessInfo

BusinessInfo mesajı, satıcının işletmesiyle ilgili önemli bilgileri içerir.

Bu mesajda fiziksel adres, müşteri hizmetleri iletişim bilgileri ve bölgeye özgü tanımlayıcılar gibi önemli işletme ayrıntıları yer alır.

Alanlar
name

string

Tanımlayıcı. İşletme bilgilerinin kaynak adı. Biçim: accounts/{account}/businessInfo

address

PostalAddress

İsteğe bağlı. İşletmenin adresi. Yalnızca region_code, address_lines, postal_code, administrative_area ve locality alanları desteklenir. Diğer tüm alanlar yoksayılır.

phone

PhoneNumber

Yalnızca çıkış. İşletmenin telefon numarası.

phone_verification_state

PhoneVerificationState

Yalnızca çıkış. İşletmenin telefon doğrulama durumu.

customer_service

CustomerService

İsteğe bağlı. İşletmenin müşteri hizmetleri.

korean_business_registration_number

string

İsteğe bağlı. XXX-XX-XXXXX biçiminde kısa çizgiyle ayrılmış 10 haneli Kore işletme tescil numarası.

CarrierRate

main_table veya single_value ile referans verilebilen operatör ücretlerinin listesi. Desteklenen kargo hizmetleri 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 adresinde tanımlanmıştır.

Alanlar
name

string

Zorunlu. Operatör ücretinin adı. Her ücret grubu için benzersiz olmalıdır.

carrier

string

Zorunlu. "UPS" veya "Fedex" gibi operatör hizmeti.

carrier_service

string

Zorunlu. "ground" veya "2 days" gibi operatör hizmeti.

origin_postal_code

string

Zorunlu. Bu kargo şirketinin ücreti için gönderim kaynağı.

percentage_adjustment

string

İsteğe bağlı. Ondalık gösterimde bir sayı olarak çarpmalı kargo ücreti değiştirici. Negatif olabilir. Örneğin, "5.4" oranı %5,4 oranında artırır, "-3" ise oranı %3 oranında azaltır.

flat_adjustment

Price

İsteğe bağlı. Ek kargo ücreti değiştirici. Negatif olabilir. Örneğin, { "amount_micros": 1, "currency_code" : "USD" } fiyata 1 TL ekler, { "amount_micros": -3, "currency_code" : "USD" } ise fiyattan 3 TL çıkarır.

ClaimHomepageRequest

ClaimHomepage yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Hak talebinde bulunulacak ana sayfanın adı. Biçim: accounts/{account}/homepage

overwrite

bool

İsteğe bağlı. true olarak ayarlandığında bu seçenek, istenen web sitesinde mevcut hak taleplerini kaldırır ve isteği gönderen hesaptaki hak talebiyle değiştirir.

CreateAndConfigureAccountRequest

CreateAndConfigureAccount yöntemi için istek mesajı.

Alanlar
account

Account

Zorunlu. Oluşturulacak hesap.

users[]

CreateUserRequest

İsteğe bağlı. Hesaba eklenecek kullanıcılar.

service[]

AddAccountService

Zorunlu. Oluşturulacak hesap ile sağlayıcı hesabı arasında bir hesap hizmeti, oluşturma işleminin bir parçası olarak başlatılır. Bu türden en az bir hizmetin sağlanması gerekir. Şu anda bunlardan tam olarak birinin account_aggregation olması gerekir. Yani bu yöntemle bağımsız hesap değil, yalnızca alt hesap oluşturabilirsiniz. Ek account_management veya product_management hizmetleri sağlanabilir.

AddAccountService

Hesap oluşturulurken hesap hizmetleri eklemeyle ilgili ek talimatlar.

Alanlar
Birlik alanı service_type. Eklenecek hizmet türü. service_type yalnızca aşağıdakilerden biri olabilir:
account_aggregation

AccountAggregation

Sağlayıcı, hesap için bir toplayıcıdır. Hesap toplama hizmet türü için yükü.

provider

string

Zorunlu. Hizmetin sağlayıcısı. Biçim: accounts/{account}

CreateRegionRequest

CreateRegion yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bölge oluşturmak için kullanılacak hesap. Biçim: accounts/{account}

region_id

string

Zorunlu. Bölgenin tanımlayıcısıdır ve aynı hesabın tüm bölgeleri için benzersizdir.

region

Region

Zorunlu. Oluşturulacak bölge.

CreateUserRequest

CreateUser yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Kullanıcının oluşturulacağı hesabın kaynak adı. Biçim: accounts/{account}

user_id

string

Zorunlu. Kullanıcının e-posta adresi (ör. john.doe@gmail.com).

user

User

Zorunlu. Oluşturulacak kullanıcı.

CustomerService

Müşteri hizmetleri bilgileri.

Alanlar
uri

string

İsteğe bağlı. Müşteri hizmetlerinin bulunabileceği URI.

email

string

İsteğe bağlı. Müşteri hizmetlerine ulaşılabilecek e-posta adresi.

phone

PhoneNumber

İsteğe bağlı. Müşteri hizmetlerinin aranabileceği telefon numarası.

CutoffTime

İş günlerinde son başvuru zamanı tanımı.

Alanlar
hour

int32

Zorunlu. Siparişin aynı gün işleme alınabilmesi için siparişin verilmesi gereken son saat.

minute

int32

Zorunlu. Siparişin aynı gün işleme alınabilmesi için verilebileceği en son saatin dakikası.

time_zone

string

Zorunlu. Saat dilimi tanımlayıcısı Örneğin, "Avrupa/Zurih".

DeleteAccountRequest

DeleteAccount yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek hesabın adı. Biçim: accounts/{account}

force

bool

İsteğe bağlı. true olarak ayarlanırsa diğer hesaplara hizmet verse veya teklifleri işlese bile hesap silinir.

DeleteRegionRequest

DeleteRegion yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek bölgenin adı. Biçim: accounts/{account}/regions/{region}

DeleteUserRequest

DeleteUser yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek kullanıcının adı. Biçim: accounts/{account}/users/{email}

accounts/{account}/users/me'taki gibi bir e-posta adresi yerine me kullanarak arayana karşılık gelen kullanıcıyı silmek de mümkündür.

DeliveryTime

Siparişten ürünün teslimine kadar geçen süre.

Alanlar
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

İsteğe bağlı. Teslimat süresinin, seçilen kargo şirketinin ayarlarına göre depo (gönderim kaynağı konumu) başına hesaplanması gerektiğini belirtir. Ayarlandığında [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] alanında nakliye süresiyle ilgili başka bir alan ayarlanmamalıdır.

min_transit_days

int32

Transfer sırasında geçen minimum iş günü sayısı. 0, aynı gün teslimat, 1 ise ertesi gün teslimat anlamına gelir. min_transit_days, max_transit_days veya transit_time_table ayarlanmalıdır. İkisi birden ayarlanamaz.

max_transit_days

int32

Transfer sırasında geçen maksimum iş günü sayısı. 0, aynı gün teslimat, 1 ise ertesi gün teslimat anlamına gelir. min_transit_days veya daha büyük olmalıdır.

cutoff_time

CutoffTime

İş günlerinde son başvuru zamanı tanımı. Yapılandırılmazsa son tarih varsayılan olarak 08:00 PST olarak belirlenir.

min_handling_days

int32

Bir siparişin gönderilmeden önce geçen minimum iş günü sayısı. 0, aynı gün kargo anlamına gelir. 1, sonraki gün kargo anlamına gelir. "min_handling_days" ve "max_handling_days" aynı anda ayarlanmalı veya ayarlanmamalıdır.

max_handling_days

int32

Bir siparişin gönderilmeden önce geçen maksimum iş günü sayısı. 0, aynı gün kargo anlamına gelir. 1, sonraki gün kargo anlamına gelir. min_handling_days veya daha büyük olmalıdır. "min_handling_days" ve "max_handling_days" aynı anda ayarlanmalı veya ayarlanmamalıdır.

transit_time_table

TransitTable

Transfer süresi tablosu, satır ve sütun boyutlarına göre transfer sırasında geçen iş günü sayısı. min_transit_days, max_transit_days veya transit_time_table ayarlanabilir ancak ikisini birden ayarlayamazsınız.

handling_business_day_config

BusinessDayConfig

Siparişlerin işlenmesi mümkün olan iş günleri. Belirtilmezse Pazartesi-Cuma iş günleri olduğu varsayılır.

transit_business_day_config

BusinessDayConfig

Siparişlerin transfer sürecinde olabileceği iş günleri. Belirtilmezse Pazartesi-Cuma iş günleri olduğu varsayılır.

DisableProgramRequest

DisableProgram yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Belirtilen hesap için katılımın devre dışı bırakılacağı programın adı. Biçim: accounts/{account}/programs/{program}

Mesafe

Maksimum teslimat yarıçapı. Bu yalnızca yerel teslimat gönderim türü için gereklidir.

Alanlar
value

int64

Mesafenin tam sayı değeri.

unit

Unit

Birim ülkeye göre farklılık gösterebilir. Birim, mil ve kilometreyi içerecek şekilde parametrelendirilir.

Birim

Birim ülkeye göre farklılık gösterebilir. Birim, mil ve kilometreyi içerecek şekilde parametrelendirilir.

Sıralamalar
UNIT_UNSPECIFIED Birim belirtilmemiş
MILES Mil birimi
KILOMETERS Birim (kilometre)

EmailPreferences

Kullanıcının etkinleştirdiği / devre dışı bıraktığı bildirim kategorileri. Kullanıcılar zorunlu duyuruları devre dışı bırakamayacağından, e-posta tercihleri zorunlu duyuruları içermez.

Alanlar
name

string

Tanımlayıcı. EmailPreferences özelliğinin adı. Uç nokta yalnızca kimliği doğrulanmış kullanıcı için desteklenir.

news_and_tips

OptInState

İsteğe bağlı. Yeni özellikler, ipuçları ve en iyi uygulamalarla ilgili güncellemeler.

OptInState

E-posta tercihinin etkinleştirilme durumu.

Sıralamalar
OPT_IN_STATE_UNSPECIFIED Kayıt durumu belirtilmemiş.
OPTED_OUT Kullanıcı bu tür e-postaları almayı devre dışı bırakmış olabilir.
OPTED_IN Kullanıcı bu tür e-postaları almayı etkinleştirmiş.
UNCONFIRMED Kullanıcı bu tür e-postaları almayı kabul etti ve onay e-postası gönderildi ancak kullanıcı henüz bu tercihi onaylamadı (yalnızca belirli ülkeler için geçerlidir).

EnableProgramRequest

EnableProgram yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Belirtilen hesap için katılımın etkinleştirileceği programın adı. Biçim: accounts/{account}/programs/{program}

GetAccountRequest

GetAccount yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak hesabın adı. Biçim: accounts/{account}

GetAutofeedSettingsRequest

GetAutofeedSettings yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Otomatik feed ayarlarının kaynak adı. Biçim: accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

GetBusinessIdentity yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. İşletme kimliğinin kaynak adı. Biçim: accounts/{account}/businessIdentity

GetBusinessInfoRequest

GetBusinessInfo yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. İşletme bilgilerinin kaynak adı. Biçim: accounts/{account}/businessInfo

GetEmailPreferencesRequest

GetEmailPreferences yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. EmailPreferences kaynağının adı. Biçim: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

GetHomepage yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak ana sayfanın adı. Biçim: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

GetOnlineReturnPolicy yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak iade politikasının adı. Biçim: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

GetProgram yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak programın adı. Biçim: accounts/{account}/programs/{program}

GetRegionRequest

GetRegion yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak bölgenin adı. Biçim: accounts/{account}/regions/{region}

GetShippingSettingsRequest

GetShippingSetting yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak gönderim ayarının adı. Biçim: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

GetTermsOfServiceAgreementState yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Hizmet Şartları sürümünün kaynak adı. Biçim: accounts/{account}/termsOfServiceAgreementState/{identifier} Tanımlayıcı biçimi: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

GetTermsOfService yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Hizmet Şartları sürümünün kaynak adı. Biçim: termsOfService/{version}

GetUserRequest

GetUser yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak kullanıcının adı. Biçim: accounts/{account}/users/{email}

accounts/{account}/users/me'teki gibi bir e-posta adresi yerine me kullanarak arayana karşılık gelen kullanıcıyı almak da mümkündür.

Üst bilgiler

Bir tablonun satır veya sütun başlıklarının boş olmayan bir listesi. prices, weights, num_items, postal_code_group_names veya location'den tam olarak biri ayarlanmalıdır.

Alanlar
prices[]

Price

Zorunlu. Dahil sipariş fiyatı üst sınırlarının listesi. Fiyat amount_micros = -1 olarak ayarlanarak son fiyatın değeri sonsuz olabilir. Örneğin, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}], "<= 10 TL", "<= 500 TL" ve "> 500 TL" başlıklarını temsil eder. Bir hizmetteki tüm fiyatlar aynı para biriminde olmalıdır. Boş bırakılamaz. -1 hariç pozitif olmalıdır. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

weights[]

Weight

Zorunlu. Dahil sipariş ağırlığı üst sınırlarının listesi. Fiyat amount_micros = -1 olarak ayarlanarak son ağırlığın değeri sonsuz olabilir. Örneğin, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}], "<= 10kg", "<= 50kg" ve "> 50kg" başlıkları temsil eder. Bir hizmetteki tüm ağırlıkların birimi aynı olmalıdır. Boş bırakılamaz. -1 hariç pozitif olmalıdır. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

number_of_items[]

string

Zorunlu. Kapsamlı öğe sayısı üst sınırlarının listesi. Son değer "infinity" olabilir. Örneğin, ["10", "50", "infinity"], "<= 10 öğe", "<= 50 öğe" ve "> 50 öğe" başlıklarını temsil eder. Boş bırakılamaz. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

postal_code_group_names[]

string

Zorunlu. Posta grubu adlarının listesi. Son değer "all other locations" olabilir. Örnek: ["zone 1", "zone 2", "all other locations"]. Referans verilen posta kodu grupları, hizmetin teslimat ülkesiyle eşleşmelidir. Boş bırakılamaz. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

locations[]

LocationIdSet

Zorunlu. Yer kimliği kümelerinin listesi. Boş bırakılamaz. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

Ana sayfa

Homepage mesajı, satıcının sistemdeki mağaza ana sayfasını temsil eder.

Satıcının ana sayfası, müşterilerin mağazalarıyla etkileşime geçtiği birincil alandır.

Ana sayfa için hak talebinde bulunulabilir ve sahiplik kanıtı olarak doğrulanabilir. Bu işlem, satıcının doğrulanmış bir web sitesi gerektiren özelliklerin kilidini açmasına olanak tanır. Daha fazla bilgi için Online mağaza URL'si doğrulaması hakkında bilgi edinin başlıklı makaleyi inceleyin.

Alanlar
name

string

Tanımlayıcı. Mağazanızın ana sayfasının kaynak adı. Biçim: accounts/{account}/homepage

claimed

bool

Yalnızca çıkış. Ana sayfa için hak talebinde bulunulup bulunulmadığı. https://support.google.com/merchants/answer/176793 adresine göz atın.

uri

string

Zorunlu. Mağazanızın ana sayfasının URI'si (genellikle bir URL).

InsertShippingSettingsRequest

InsertShippingSetting yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu ürünün ekleneceği hesap. Biçim: accounts/{account}

shipping_setting

ShippingSettings

Zorunlu. Hesabın yeni sürümü.

ListAccountIssuesRequest

ListAccountIssues yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu sorun koleksiyonunun sahibi olan üst öğe. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum sorun sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 50 kullanıcı döndürülür. Maksimum değer 100'dür; 100'ün üzerindeki değerler 100'e zorlanacaktır

page_token

string

İsteğe bağlı. Önceki bir ListAccountIssues çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListAccountIssues parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

language_code

string

İsteğe bağlı. Yanıtta, belirtilen dilde insan tarafından okunabilir alanlar bulunur. Biçim BCP-47'dir (ör. en-US veya sr-Latn). Değer belirtilmezse en-US kullanılır.

time_zone

string

İsteğe bağlı. Kullanıcılar tarafından okunabilen alanlarda saatleri yerelleştirmek için kullanılan IANA saat dilimi. Örneğin, "Amerika/Los_Angeles". Ayarlanmazsa "America/Los_Angeles" kullanılır.

ListAccountIssuesResponse

ListAccountIssues yöntemi için yanıt mesajı.

Alanlar
account_issues[]

AccountIssue

Belirtilen hesaptaki sorunlar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListAccountsRequest

ListAccounts yöntemi için istek mesajı.

Alanlar
page_size

int32

İsteğe bağlı. Döndürülecek maksimum hesap sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 250 hesap döndürülür. Maksimum değer 500'dür. 500'den yüksek değerler 500 olarak zorlanacaktır.

page_token

string

İsteğe bağlı. Önceki bir ListAccounts çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListAccounts parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlı. Yalnızca filtreyle eşleşen hesapları döndürür. Daha fazla bilgi için filtre söz dizimi referansı bölümüne bakın.

ListAccountsResponse

ListAccounts yöntemi için yanıt mesajı.

Alanlar
accounts[]

Account

ListAccountsRequest ile eşleşen hesaplar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListOnlineReturnPoliciesRequest

ListOnlineReturnPolicies yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. İade politikalarının listeleneceği satıcı hesabı. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum OnlineReturnPolicy kaynağı sayısı. Belirtilen satıcının iade politikası sayısı pageSize'ten azsa hizmet bu değerden daha az sayıda sonuç döndürür. Varsayılan değer 10'dur. Maksimum değer 100'dür. Maksimumdan yüksek bir değer belirtilirse pageSize varsayılan olarak maksimum olur.

page_token

string

İsteğe bağlı. Önceki bir ListOnlineReturnPolicies çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için sayfa jetonunu sağlayın.

Sayfalandırma yaparken ListOnlineReturnPolicies parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Önceki istek yanıtında jeton nextPageToken olarak döndürüldü.

ListOnlineReturnPoliciesResponse

ListOnlineReturnPolicies yöntemi için yanıt mesajı.

Alanlar
online_return_policies[]

OnlineReturnPolicy

Alınan iade politikaları.

next_page_token

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListProgramsRequest

ListPrograms yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Tüm programların alınacağı hesabın adı. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Tek bir yanıtta döndürülecek maksimum program sayısı. Belirtilmemişse (veya 0 ise) varsayılan boyut 1000'dir. Maksimum değer 1.000'dür. 1.000'den büyük değerler 1.000'e zorlanacaktır.

page_token

string

İsteğe bağlı. Önceki bir ListPrograms çağrısından alınan devam jetonu. Sonraki sayfayı almak için bunu sağlayın.

ListProgramsResponse

ListPrograms yöntemi için yanıt mesajı.

Alanlar
programs[]

Program

Belirtilen hesaptaki programlar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListRegionsRequest

ListRegions yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bölgelerinin listeleneceği hesap. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum bölge sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 bölge döndürülür. Maksimum değer 1.000'dür. 1.000'den büyük değerler 1.000'e zorlanacaktır.

page_token

string

İsteğe bağlı. Önceki bir ListRegions çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListRegions parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListRegionsResponse

ListRegions yöntemi için yanıt mesajı.

Alanlar
regions[]

Region

Belirtilen satıcının bulunduğu bölgeler.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListSubAccountsRequest

ListSubAccounts yöntemi için istek mesajı.

Alanlar
provider

string

Zorunlu. Üst hesap. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum hesap sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 250 hesap döndürülür. Maksimum değer 500'dür. 500'den yüksek değerler 500 olarak zorlanacaktır.

page_token

string

İsteğe bağlı. Önceki bir ListAccounts çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListAccounts parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListSubAccountsResponse

ListSubAccounts yöntemi için yanıt mesajı.

Alanlar
accounts[]

Account

Belirtilen üst hesabın toplayıcısı olduğu hesaplar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

ListUsersRequest

ListUsers yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu kullanıcı koleksiyonunun sahibi olan üst öğe. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum kullanıcı sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 50 kullanıcı döndürülür. Maksimum değer 100'dür; 100'ün üzerindeki değerler 100'e zorlanacaktır

page_token

string

İsteğe bağlı. Önceki bir ListUsers çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListUsers parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUsersResponse

ListUsers yöntemi için yanıt mesajı.

Alanlar
users[]

User

Belirtilen hesaptaki kullanıcılar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

LocationIdSet

Yer kimliği kümelerinin listesi. Boş bırakılamaz. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

Alanlar
location_ids[]

string

Zorunlu. Boş olmayan bir konum kimlikleri listesi. Tüm konumlar aynı konum türünde olmalıdır (ör. eyalet).

MinimumOrderValueTable

Alışveriş yapma yerine teslimat özelliği için mağaza başına minimum sipariş değerleri tablosu.

Alanlar
store_code_set_with_movs[]

StoreCodeSetWithMov

Zorunlu. Aynı minimum sipariş değerini (MOV) paylaşan mağaza kodu gruplarının listesi. En az iki grup gereklidir ve son grup boş olmalıdır. Bu, "diğer tüm mağazalar için MOV" anlamına gelir. Her mağaza kodu, tüm setlerde yalnızca bir kez görünebilir. Bir hizmetteki tüm fiyatlar aynı para biriminde olmalıdır.

StoreCodeSetWithMov

Aynı minimum sipariş değerini paylaşan mağaza kodu gruplarının listesi. En az iki grup gereklidir ve son grup boş olmalıdır. Bu, "diğer tüm mağazalar için MOV" anlamına gelir. Her mağaza kodu, tüm setlerde yalnızca bir kez görünebilir. Bir hizmetteki tüm fiyatlar aynı para biriminde olmalıdır.

Alanlar
store_codes[]

string

İsteğe bağlı. Benzersiz mağaza kodlarının listesi veya her şeyi kapsayan için boş.

value

Price

Belirtilen mağazalar için minimum sipariş değeri.

OnlineReturnPolicy

Online iade politikası nesnesi. Bu özellik şu anda reklamlar ve ücretsiz listeleme programlarının iade politikalarını temsil etmek için kullanılmaktadır.

Alanlar
name

string

Tanımlayıcı. OnlineReturnPolicy kaynağının adı. Biçim: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Yalnızca çıkış. Google tarafından oluşturulan iade politikası kimliği.

label

string

Zorunlu. Bu alan, iade politikasının kullanıcı tanımlı benzersiz etiketini temsil eder. Aynı etiketin, aynı ülke için farklı iade politikalarında kullanılamayacağını unutmayın. Bir üründe belirli bir etiket özelliği belirtilmediği sürece politikalar otomatik olarak "varsayılan" olarak etiketlenir. Belirli ürün gruplarına özel bir iade politikası atamak için İade politikası etiketi bölümündeki talimatları uygulayın. Etiket en fazla 50 karakter içerebilir.

countries[]

string

Zorunlu. İade politikasının geçerli olduğu satış ülkeleri. Değerler, geçerli bir 2 harfli ISO 3166 kodu olmalıdır.

policy

Policy

İade politikası.

restocking_fee

RestockingFee

Tüm iade nedeni kategorileri için geçerli olan yeniden stoka ekleme ücreti. Değer ayarlanmamışsa bu, ücretsiz yeniden stoka ekleme ücreti olarak değerlendirilir.

return_methods[]

ReturnMethod

Müşterilerin ürünü iade edebileceği iade yöntemleri. İade politikasının türü noReturns değilse bu değerin boş olmaması gerekir.

item_conditions[]

ItemCondition

İade politikasının türü "noReturns" olmadığı sürece, iade için kabul edilen öğe koşulları boş olmamalıdır.

return_shipping_fee

ReturnShippingFee

İade gönderim ücreti. Yalnızca müşterinin iade etiketini indirip yazdırması gerektiğinde ayarlanmalıdır.

return_policy_uri

string

Zorunlu. İade politikası uri'si. Bu, Google tarafından politika için mantık kontrolü yapmak amacıyla kullanılabilir. Geçerli bir URL olmalıdır.

accept_defective_only

bool

Bu alan, satıcının iade için yalnızca kusurlu ürünleri kabul edip etmediğini belirtir ve zorunludur.

process_refund_days

int32

Bu alan, satıcıların geri ödemeleri işleme almasının ne kadar süreceğini belirtir. Alan isteğe bağlıdır.

accept_exchange

bool

Bu alan, satıcının müşterilerin ürün değişimine izin verip vermediğini belirtir. Bu alan zorunludur.

ItemCondition

Mevcut öğelerin durumu.

Sıralamalar
ITEM_CONDITION_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
NEW Yeni'yi tıklayın.
USED Kullanılmış.

Politika

Kullanılabilir politikalar.

Alanlar
type

Type

Politika türü.

days

int64

Ürünlerin teslimattan sonra iade edilebileceği gün sayısı. Bir gün, teslimat zaman damgasından sonraki 24 saat olarak tanımlanır. NUMBER_OF_DAYS_AFTER_DELIVERY iadeleri için gereklidir.

Tür

İade politikası türleri.

Sıralamalar
TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
NUMBER_OF_DAYS_AFTER_DELIVERY Teslimattan sonra iadenin geçerli olduğu gün sayısı.
NO_RETURNS İade yok.
LIFETIME_RETURNS Ömür boyu iade.

RestockingFee

Stoka ekleme ücreti. Bu, sabit ücret veya mikro yüzde olabilir.

Alanlar

Birlik alanı type.

type yalnızca aşağıdakilerden biri olabilir:

fixed_fee

Price

Sabit stok tamamlama ücreti.

micro_percent

int32

Mikro ölçekte toplam fiyatın yüzdesi. 15.000.000, toplam fiyatın% 15'inin tahsil edileceği anlamına gelir.

ReturnMethod

Kullanılabilen iade yöntemleri.

Sıralamalar
RETURN_METHOD_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
BY_MAIL Postayla iade edin.
IN_STORE Mağazadan iade edin.
AT_A_KIOSK Kiosktan iade edin.

ReturnShippingFee

İade gönderim ücreti. Bu, sabit bir ücret veya müşterinin gerçek gönderim maliyetini ödediğini belirten bir boole değeri olabilir.

Alanlar
type

Type

Zorunlu. İade gönderim ücreti türü.

fixed_fee

Price

Sabit iade gönderim ücreti tutarı. Bu değer yalnızca tür FIXED olduğunda geçerlidir. Tür FIXED ise ve bu değer ayarlanmamışsa iade kargo ücreti ücretsiz olarak değerlendirilir.

Tür

İade gönderim ücreti türleri.

Sıralamalar
TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
FIXED İade gönderim ücreti sabit bir değerdir.
CUSTOMER_PAYING_ACTUAL_FEE Gerçek iade kargo ücretini müşteriler öder.

PhoneVerificationState

Telefonla doğrulama durumu.

Sıralamalar
PHONE_VERIFICATION_STATE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
PHONE_VERIFICATION_STATE_VERIFIED Telefon doğrulanmalıdır.
PHONE_VERIFICATION_STATE_UNVERIFIED Telefon doğrulanmadı

Program

Belirtilen hesap için belirli bir programa katılımı tanımlar.

Programlar, satıcı hesaplarına işlev eklemek için bir mekanizma sağlar. Bunun tipik bir örneği, satıcının mağazasındaki ürünlerin Google'da ücretsiz olarak gösterilmesini sağlayan ücretsiz ürün listelemeleri programıdır.

Alanlar
name

string

Tanımlayıcı. Programın kaynak adı. Biçim: accounts/{account}/programs/{program}

documentation_uri

string

Yalnızca çıkış. Programı açıklayan bir Merchant Center yardım sayfasının URL'si.

state

State

Yalnızca çıkış. Hesabın programdaki katılım durumu.

active_region_codes[]

string

Yalnızca çıkış. Hesabın programa aktif olarak katıldığı bölgeler. Etkin bölgeler, bölgeleri etkileyen tüm program koşullarının karşılandığı bölgeler olarak tanımlanır.

Bölge kodları CLDR tarafından tanımlanır. Bu, programın özel olarak geçerli olduğu bir ülkedir veya programın dünya genelinde geçerli olduğu durumlarda 001 olur.

unmet_requirements[]

Requirement

Yalnızca çıkış. Hesabın henüz karşılamadığı ve programa katılımı etkileyen koşullar.

Gereksinim

Programa katılım için belirtilen bir koşulu tanımlar.

Alanlar
title

string

Yalnızca çıkış. Şartın adı.

documentation_uri

string

Yalnızca çıkış. Şartı açıklayan bir yardım sayfasının URL'si.

affected_region_codes[]

string

Yalnızca çıkış. Şu anda bu şartın karşılanmaması nedeniyle etkilenen bölgeler.

Bölge kodları CLDR tarafından tanımlanır. Bu, programın özel olarak geçerli olduğu bir ülkedir veya programın dünya genelinde geçerli olduğu durumlarda 001 olur.

Eyalet

Hesap için olası program katılım durumları.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
NOT_ELIGIBLE Hesap programa katılmaya uygun değil.
ELIGIBLE Hesap programa katılmaya uygundur.
ENABLED Program, hesap için etkinleştirilmiş olmalıdır.

RateGroup

Kargo ücreti grubu tanımları. Yalnızca sonuncusunun boş applicable_shipping_labels değerine sahip olmasına izin verilir. Bu, "diğer her şey" anlamına gelir. Diğer applicable_shipping_labels çakışmamalıdır.

Alanlar
applicable_shipping_labels[]

string

Zorunlu. Bu ücret grubunun geçerli olduğu ürünleri tanımlayan kargo etiketlerinin listesi. Bu bir ayrım operatörüdür: Ücret grubunun uygulanması için etiketlerden yalnızca birinin eşleşmesi gerekir. Yalnızca bir hizmetin son ücret grubu için boş olabilir.

subtables[]

Table

İsteğe bağlı. main_table tarafından başvurulan alt tabloların listesi. Yalnızca main_table ayarlandıysa ayarlanabilir.

carrier_rates[]

CarrierRate

İsteğe bağlı. main_table veya single_value ile referans verilebilen operatör ücretlerinin listesi.

single_value

Value

Ücret grubunun değeri (ör. sabit ücret 10 TL). Yalnızca main_table ve subtables ayarlanmamışsa ayarlanabilir.

main_table

Table

single_value yeterince açıklayıcı olmadığında ücret grubunu tanımlayan bir tablo. Yalnızca single_value ayarlanmamışsa ayarlanabilir.

name

string

İsteğe bağlı. Ücret grubunun adı. Ayarlanırsa kargo hizmetinde benzersiz olmalıdır.

Bölge

Hem RegionalInventory hem de ShippingSettings hizmetleriyle hedef olarak kullanabileceğiniz bir coğrafi bölgeyi temsil eder. Bölgeleri posta kodu koleksiyonları olarak veya bazı ülkelerde önceden tanımlanmış coğrafi hedefleri kullanarak tanımlayabilirsiniz. Daha fazla bilgi için Bölge oluşturma başlıklı makaleyi inceleyin.

Alanlar
name

string

Tanımlayıcı. Bölgenin kaynak adı. Biçim: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

İsteğe bağlı. Bölge alanını tanımlayan posta kodlarının listesi.

geotarget_area

GeoTargetArea

İsteğe bağlı. Bölge alanını tanımlayan coğrafi hedeflerin listesi.

regional_inventory_eligible

BoolValue

Yalnızca çıkış. Bölgenin, bölgesel envanter yapılandırmasında kullanılıp kullanılamayacağını belirtir.

shipping_eligible

BoolValue

Yalnızca çıkış. Bölgenin, kargo hizmetleri yapılandırmasında kullanılıp kullanılamayacağını belirtir.

display_name

string

İsteğe bağlı. Bölgenin görünen adı.

GeoTargetArea

Bölge alanını tanımlayan coğrafi hedeflerin listesi.

Alanlar
geotarget_criteria_ids[]

int64

Zorunlu. Boş olmayan bir konum kimlikleri listesi. Tüm konumlar aynı konum türünde (ör. eyalet) olmalıdır.

PostalCodeArea

Bölge alanını tanımlayan posta kodlarının listesi. Not: Posta kodları kullanılarak tanımlanan tüm bölgelere hesabın ShippingSettings.postalCodeGroups kaynağından erişilebilir.

Alanlar
region_code

string

Zorunlu. CLDR bölge kodu veya posta kodu grubunun geçerli olduğu ülke.

postal_codes[]

PostalCodeRange

Zorunlu. Posta kodu aralığı.

PostalCodeRange

Bölge alanını tanımlayan bir posta kodu aralığı.

Alanlar
begin

string

Zorunlu. Alanı tanımlayan aralığın dahili alt sınırını belirten bir posta kodu veya form ön ekiyle oluşturulmuş bir kalıp*. Örnek değerler: 94108, 9410*, 9*.

end

string

İsteğe bağlı. Alanı tanımlayan aralığın kapsayıcı üst sınırını belirten bir posta kodu veya prefix* biçiminde bir kalıp. postalCodeRangeBegin ile aynı uzunlukta olmalıdır: postalCodeRangeBegin bir posta koduysa postalCodeRangeEnd de bir posta kodu olmalıdır; postalCodeRangeBegin bir kalıpsa postalCodeRangeEnd de aynı ön ek uzunluğuna sahip bir kalıp olmalıdır. İsteğe bağlı: Ayarlanmazsa bölge, postalCodeRangeBegin ile eşleşen tüm posta kodları olarak tanımlanır.

Zorunlu

Kabul edilmesi gereken hizmet şartlarını açıklar.

Alanlar
terms_of_service

string

Kabul edilmesi gereken termsOfService.

tos_file_uri

string

Hizmet Şartları dosyasının tam URL'si. Bu alan TermsOfService.file_uri ile aynıdır ve yalnızca kolaylık sağlamak için buraya eklenmiştir.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

RetrieveForApplicationTermsOfServiceAgreementState yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. TermsOfServiceAgreementState biçiminin alınacağı hesap: accounts/{account}

RetrieveLatestTermsOfServiceRequest

RetrieveLatestTermsOfService yöntemi için istek mesajı.

Alanlar
region_code

string

Zorunlu. CLDR tarafından tanımlanan bölge kodu. Hükümler ve Koşullar belirli bir ülke için geçerliyse bu ülke, Hükümler ve Koşullar dünya genelinde geçerliyse 001 olur.

kind

TermsOfServiceKind

Zorunlu. Bu hizmet şartları sürümünün geçerli olduğu tür.

Satır

Hücrelerin listesini ekleyin.

Alanlar
cells[]

Value

Zorunlu. Satırı oluşturan hücrelerin listesi. İki boyutlu tablolar için columnHeaders ile aynı uzunlukta, tek boyutlu tablolar için 1 uzunluğunda olmalıdır.

Hizmet

Kargo hizmeti.

Alanlar
delivery_countries[]

string

Zorunlu. Hizmetin geçerli olduğu ülkelerin CLDR bölge kodu.

rate_groups[]

RateGroup

İsteğe bağlı. Kargo ücreti grubu tanımları. Yalnızca sonuncusunun boş applicable_shipping_labels değerine sahip olmasına izin verilir. Bu, "diğer her şey" anlamına gelir. Diğer applicable_shipping_labels çakışmamalıdır.

loyalty_programs[]

LoyaltyProgram

İsteğe bağlı. Bu kargo hizmetinin kullanılabildiği bağlılık programları.

service_name

string

Zorunlu. Hizmetin serbest biçimli adı. Hedef hesapta benzersiz olmalıdır.

active

bool

Zorunlu. Gönderim hizmetinin etkin durumunu gösteren bir boole değeri.

currency_code

string

Bu hizmetin geçerli olduğu para biriminin CLDR kodu. Ücret gruplarındaki fiyatlarla eşleşmelidir.

delivery_time

DeliveryTime

Zorunlu. Siparişten ürünün teslimine kadar geçen süre.

shipment_type

ShipmentType

Bu hizmetin sipariş gönderdiği konum türleri.

minimum_order_value

Price

Bu hizmet için minimum sipariş değeri. Ayarlanırsa müşterilerin en az bu tutarı harcaması gerektiğini gösterir. Bir hizmetteki tüm fiyatlar aynı para biriminde olmalıdır. minimum_order_value_table ile birlikte ayarlanamaz.

minimum_order_value_table

MinimumOrderValueTable

Alışveriş yapma yerine teslimat özelliği için mağaza başına minimum sipariş değerleri tablosu. minimum_order_value ile birlikte ayarlanamaz.

store_config

StoreConfig

Ürünlerinizin teslim edildiği mağazaların listesi. Bu yalnızca yerel teslimat gönderim türü için geçerlidir.

LoyaltyProgram

Satıcı tarafından sağlanan bağlılık programı.

Alanlar
loyalty_program_tiers[]

LoyaltyProgramTiers

İsteğe bağlı. Bu kargo hizmetinin bağlılık programı katmanı.

program_label

string

Merchant Center'daki bağlılık programı ayarlarınızda belirtilen bağlılık programı etiketidir. Bu alt özellik, Google'ın bağlılık programınızı uygun tekliflerle eşleştirmesini sağlar.

LoyaltyProgramTiers

Satıcı bağlılık programının alt kümesi.

Alanlar
tier_label

string

Katman etiketi [tier_label] alt özelliği, farklı katmanlarda sunulan seviye avantajları arasındaki farkları belirtir. Bu değer, Merchant Center'daki program ayarlarınızda belirlenir ve bağlılık programınızda yalnızca 1 katman olsa bile veri kaynağı değişiklikleri için gereklidir.

ShipmentType

Kargo hizmetinin gönderim türü.

Sıralamalar
SHIPMENT_TYPE_UNSPECIFIED Bu hizmette gönderim türü belirtilmedi.
DELIVERY Bu hizmet, siparişleri müşteri tarafından seçilen bir adrese gönderir.
LOCAL_DELIVERY Bu hizmet, siparişleri müşteri tarafından seçilen bir adrese gönderir. Sipariş, yakınınızdaki bir yerel mağazadan gönderilir.
COLLECTION_POINT Bu hizmet, siparişleri müşteri tarafından seçilen bir adrese gönderir. Sipariş, bir teslim noktasından gönderilir.

StoreConfig

Ürünlerinizin teslim edildiği mağazaların listesi. Bu yalnızca yerel teslimat gönderim türü için geçerlidir.

Alanlar
store_codes[]

string

İsteğe bağlı. Yerel teslimat sunan mağaza kodlarının listesi. Boşsa all_stores doğru olmalıdır.

store_service_type

StoreServiceType

Bu satıcı tarafından listelenen tüm mağazaların veya seçili mağazaların yerel teslimat sunup sunmadığını belirtir.

cutoff_config

CutoffConfig

Yerel teslimatla ilgili yapılandırmalar gün için sona erer.

service_radius

Distance

Maksimum teslimat yarıçapı. Bu yalnızca yerel teslimat gönderim türü için gereklidir.

CutoffConfig

Yerel teslimatla ilgili yapılandırmalar gün için sona erer.

Alanlar
local_cutoff_time

LocalCutoffTime

Yerel yayının gün içinde sona erdiği saat.

store_close_offset_hours

int64

Yalnızca yerel teslimat karşılama ile geçerlidir. Son sipariş saatini, mağaza kapanmadan kaç saat önce sipariş verilmesi gerektiği şeklinde gösterir. local_cutoff_time ile birlikte kullanılamaz.

no_delivery_post_cutoff

bool

Satıcılar, n gün yerel teslimat için yapılandırılmış bir kargo hizmeti varsa n+1 gün yerel teslimat seçeneğini devre dışı bırakabilir. Örneğin, kargo hizmeti aynı gün teslimat sunuyorsa ve son sipariş süresi geçmişse bu alanın true olarak ayarlanması, hesaplanan kargo hizmeti ücretinin NO_DELIVERY_POST_CUTOFF olarak döndürülmesine neden olur. Aynı örnekte, bu alanın false olarak ayarlanması, hesaplanan kargo süresinin bir gün olmasını sağlar. Bu yalnızca yerel yayınlama içindir.

LocalCutoffTime

Yerel yayının gün içinde sona erdiği saat.

Alanlar
hour

int64

Yerel teslimat siparişlerinin aynı gün işleme alınabilmesi için saat içinde verilmesi gerekir.

minute

int64

Aynı gün işleme alınabilmesi için dakikalar içinde teslimat siparişlerinin en geç saat 12:00'ye kadar verilmesi gerekir.

StoreServiceType

Satıcı tarafından listelenen tüm mağazaların veya belirli mağazaların yerel teslimat hizmeti sağlayıp sağlamadığını belirtir.

Sıralamalar
STORE_SERVICE_TYPE_UNSPECIFIED Mağaza hizmeti türü belirtilmedi.
ALL_STORES Bu satıcı tarafından listelenen mevcut ve gelecekteki tüm mağazaların yerel teslimat hizmeti sağlayıp sağlamadığını belirtir.
SELECTED_STORES Yalnızca store_codes adresinde listelenen mağazaların yerel teslimat için uygun olduğunu belirtir.

ShippingSettings

Satıcı hesabının kargo ayarı.

Alanlar
name

string

Tanımlayıcı. Gönderim ayarının kaynak adı. Biçim: accounts/{account}/shippingSetting

services[]

Service

İsteğe bağlı. Hedef hesabın hizmet listesi.

warehouses[]

Warehouse

İsteğe bağlı. services'te referans verilebilen depoların listesi.

etag

string

Zorunlu. Bu alan, asynkron sorununu önlemek için kullanılır. Kargo ayar verilerinin, çağrı alma ve çağrı ekleme arasında değişmediğinden emin olun. Kullanıcı aşağıdaki adımları uygulamalıdır:

  1. İlk kargo ayarının oluşturulması için etag alanını boş dize olarak ayarlayın.

  2. İlk oluşturma işleminden sonra, çağrı ekleme işleminden önce bir etag ve mevcut gönderim ayarı verilerini almak için get yöntemini çağırın.

  3. İstediğiniz kargo ayar bilgilerini girin.

  4. 2. adımdan elde edilen etag ile istenen gönderim ayarı bilgilerini kullanarak ekleme yöntemini çağırın.

  5. Gönderim ayarı verileri 2. adım ile 4. adım arasında değiştiyse. Etag, gönderim ayarı verileri her değiştiğinde değiştiği için ekleme isteği başarısız olur. Kullanıcı, yeni etag ile 2-4 arasındaki adımları tekrarlamalıdır.

Tablo

single_value yeterince açıklayıcı olmadığında ücret grubunu tanımlayan bir tablo.

Alanlar
rows[]

Row

Zorunlu. Tabloyu oluşturan satırların listesi. row_headers ile aynı uzunlukta olmalıdır.

name

string

Tablonun adı. Alt tablolar için gereklidir, ana tablo için yoksayılır.

row_headers

Headers

Zorunlu. Tablo satırlarının başlıkları.

column_headers

Headers

Tablonun sütunlarının başlıkları. İsteğe bağlı: Ayarlanmamışsa tabloda yalnızca bir boyut bulunur.

TermsOfService

TermsOfService mesajı, satıcıların belirli özelliklere veya hizmetlere erişmek için kabul etmesi gereken hizmet şartlarının belirli bir sürümünü temsil eder (https://support.google.com/merchants/answer/160173) adresine bakın).

Bu mesaj, satıcıların hizmeti kullanmak için gerekli yasal sözleşmeleri kabul etmesini sağlayarak ilk katılım süreci için önemlidir. Satıcılar, RetrieveLatestTermsOfService üzerinden belirli bir kind ve region için en son hizmet şartlarını alabilir ve gerektiğinde AcceptTermsOfService üzerinden kabul edebilir.

Alanlar
name

string

Tanımlayıcı. Hizmet Şartları sürümünün kaynak adı. Biçim: termsOfService/{version}

region_code

string

CLDR tarafından tanımlanan bölge kodu. Bu, Hükümler ve Koşullar'ın yalnızca belirli bir ülke için geçerli olduğu bir ülke veya 001 aynı TermsOfService'ın herhangi bir ülkede imzalanabileceği bir ülkedir. Ancak dünya genelinde geçerli olan bir Hükümler ve Koşullar belgesi imzalarken belirli bir ülkenin belirtilmesini beklediğimizi unutmayın (bu, satıcının işletmesinin bulunduğu ülke veya programın katılım ülkesi olmalıdır).

kind

TermsOfServiceKind

Bu hizmet şartları sürümünün geçerli olduğu tür.

external

bool

Bu hizmet şartları sürümünün harici olup olmadığı. Harici hizmet şartı sürümleri, yalnızca harici süreçler aracılığıyla kabul edilebilir. Satıcı, kullanıcı arayüzü veya API üzerinden doğrudan kabul edemez.

file_uri

string

İmzalayan kullanıcılara gösterilmesi gereken hizmet şartları dosyasının URI'si.

TermsOfServiceAgreementState

Bu kaynak, belirli bir hesap ve hizmet şartları türü için sözleşme durumunu temsil eder. Durum aşağıdaki gibidir:

  • Satıcı bir hizmet şartlarını kabul ettiyse: accepted doldurulur, aksi takdirde boş olur.
  • Satıcının bir hizmet şartlarını imzalaması gerekiyorsa: required doldurulur, aksi takdirde boş bırakılır.

Hem required hem de accepted değerinin bulunabileceğini unutmayın. Bu durumda, accepted hizmet şartlarının valid_until alanında bir son kullanma tarihi belirlenir. Hesabın geçerli bir sözleşmeye sahip olmaya devam etmesi için required hizmet şartlarının valid_until tarihinden önce kabul edilmesi gerekir. Yeni hizmet şartlarını kabul ederken üçüncü tarafların, ilgili hizmet şartları sözleşmesiyle ilişkili metni göstermesini bekleriz (metni içeren dosyanın URL'si, aşağıdaki Zorunlu mesaja tos_file_uri olarak eklenir. Hizmet şartlarının gerçek kabulü, TermsOfService kaynağında accept işlevi çağrılarak yapılır.

Alanlar
name

string

Tanımlayıcı. Hizmet Şartları sürümünün kaynak adı. Biçim: accounts/{account}/termsOfServiceAgreementState/{identifier} Tanımlayıcı biçimi: {TermsOfServiceKind}-{country} Örneğin, bir tanımlayıcı şu şekilde olabilir: MERCHANT_CENTER-US

region_code

string

https://cldr.unicode.org/ tarafından tanımlanan bölge kodu. Bu, mevcut durumun geçerli olduğu ülkedir.

terms_of_service_kind

TermsOfServiceKind

Belirli sürümle ilişkili Hizmet Şartları türü.

accepted

Accepted

Bu tür ve ilişkili region_code için kabul edilen hizmet şartları

required

Required

Gerekli hizmet şartları

TermsOfServiceKind

TermsOfService türü.

Sıralamalar
TERMS_OF_SERVICE_KIND_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
MERCHANT_CENTER Merchant Center uygulaması.

TransitTable

Transfer süresi tablosu, satır ve sütun boyutlarına göre transfer sırasında geçen iş günü sayısı. min_transit_days, max_transit_days veya transit_time_table ayarlanabilir ancak ikisini birden ayarlayamazsınız.

Alanlar
postal_code_group_names[]

string

Zorunlu. Bölge adlarının listesi Region.name . Son değer "all other locations" olabilir. Örnek: ["zone 1", "zone 2", "all other locations"]. Referans verilen posta kodu grupları, hizmetin teslimat ülkesiyle eşleşmelidir.

transit_time_labels[]

string

Zorunlu. Nakliye süresi etiketlerinin listesi. Son değer "all other labels" olabilir. Örnek: ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Zorunlu. Yalnızca bir postal_code_group_names veya transit_time_labels boyutu grubu varsa her biri bu boyut için tek bir değere sahip birden çok satır vardır. İki boyut varsa her satır bir postal_code_group_names'e, sütunlar (değerler) ise bir transit_time_labels'a karşılık gelir.

TransitTimeRow

Yalnızca bir postal_code_group_names veya transit_time_labels boyutu grubu varsa her biri bu boyut için tek bir değere sahip birden çok satır vardır. İki boyut varsa her satır bir postal_code_group_names'e, sütunlar (değerler) ise bir transit_time_labels'a karşılık gelir.

Alanlar
values[]

TransitTimeValue

Zorunlu. İş günü cinsinden nakliye süresi aralığı (min-max).

TransitTimeValue

İş günü cinsinden nakliye süresi aralığı (min-max).

Alanlar
min_transit_days

int32

İş günü cinsinden minimum nakliye süresi aralığı. 0, aynı gün teslimat, 1 ise ertesi gün teslimat anlamına gelir.

max_transit_days

int32

min_transit_days veya daha büyük olmalıdır.

UnclaimHomepageRequest

UnclaimHomepage yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Hak talebinin kaldırılacağı ana sayfanın adı. Biçim: accounts/{account}/homepage

UpdateAccountRequest

UpdateAccount yöntemi için istek mesajı.

Alanlar
account

Account

Zorunlu. Hesabın yeni sürümü.

update_mask

FieldMask

İsteğe bağlı. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

UpdateAutofeedSettings yöntemi için istek mesajı.

Alanlar
autofeed_settings

AutofeedSettings

Zorunlu. Otomatik feed ayarının yeni sürümü.

update_mask

FieldMask

Zorunlu. Güncellenen alanların listesi.

UpdateBusinessIdentityRequest

UpdateBusinessIdentity yöntemi için istek mesajı.

Alanlar
business_identity

BusinessIdentity

Zorunlu. İşletme kimliğinin yeni sürümü.

update_mask

FieldMask

İsteğe bağlı. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

UpdateBusinessInfo yöntemi için istek mesajı.

Alanlar
business_info

BusinessInfo

Zorunlu. İşletme bilgilerinin yeni sürümü.

update_mask

FieldMask

İsteğe bağlı. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

UpdateEmailPreferences yöntemi için istek mesajı.

Alanlar
email_preferences

EmailPreferences

Zorunlu. Güncellenecek e-posta tercihleri.

update_mask

FieldMask

Zorunlu. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • news_and_tips

UpdateHomepageRequest

UpdateHomepage yöntemi için istek mesajı.

Alanlar
homepage

Homepage

Zorunlu. Ana sayfanın yeni sürümü.

update_mask

FieldMask

İsteğe bağlı. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • uri

UpdateRegionRequest

UpdateRegion yöntemi için istek mesajı.

Alanlar
region

Region

Zorunlu. Güncellenen bölge.

update_mask

FieldMask

İsteğe bağlı. Güncellenecek alanları belirten, virgülle ayrılmış alan maskesi. Örnek: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

UpdateUser yöntemi için istek mesajı.

Alanlar
user

User

Zorunlu. Kullanıcının yeni sürümü.

Kendi e-posta adresinizi belirtmek için me kullanın (ör. accounts/{account}/users/me).

update_mask

FieldMask

İsteğe bağlı. Güncellenen alanların listesi.

Aşağıdaki alanlar desteklenir (hem snake_case hem de lowerCamelCase içinde):

  • access_rights

Kullanıcı

User mesajı, bir Merchant Center hesabıyla ilişkili bir kullanıcıyı temsil eder. Hesaptaki kullanıcı izinlerini ve erişim haklarını yönetmek için kullanılır. Daha fazla bilgi için Kullanıcılar ve erişim düzeyleriyle ilgili sık sorulan sorular başlıklı makaleyi inceleyin.

Alanlar
name

string

Tanımlayıcı. Kullanıcının kaynak adı. Biçim: accounts/{account}/user/{email}

Kendi e-posta adresinizi belirtmek için me kullanın (ör. accounts/{account}/users/me).

state

State

Yalnızca çıkış. Kullanıcının durumu.

access_rights[]

AccessRight

İsteğe bağlı. Kullanıcının sahip olduğu erişim hakları.

Eyalet

Kullanıcının olası durumları.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
PENDING Kullanıcının onayı bekleniyor. Bu durumda, kullanıcının diğer işlemleri gerçekleştirmeden önce daveti kabul etmesi gerekir.
VERIFIED Kullanıcı doğrulanmış olmalıdır.

Değer

Bir ücret grubunun tek değeri veya ücret grubu tablosunun hücresinin değeri. no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name seçeneklerinden tam olarak biri ayarlanmalıdır.

Alanlar
no_shipping

bool

Doğru ise ürün gönderilemez. Ayarlandığında doğru olmalıdır, yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

flat_rate

Price

Sabit ücret. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

price_percentage

string

Ondalık gösterimle sayı olarak temsil edilen fiyat yüzdesi (ör. "5.4"). Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

carrier_rate

string

Aynı ücret grubunda tanımlanan bir kargo ücretine atıfta bulunan kargo ücretinin adı. Yalnızca diğer tüm alanlar ayarlanmamışsa ayarlanabilir.

subtable

string

Alt tablonun adı. Yalnızca tablo hücrelerinde ayarlanabilir (örneğin, tek değerler için değil) ve yalnızca diğer tüm alanlar ayarlanmamışsa.

Depo

Envanteri depolayan ve işleyen bir sipariş karşılama deposu.

Alanlar
name

string

Zorunlu. Deponun adı. Hesap içinde benzersiz olmalıdır.

shipping_address

Address

Zorunlu. Deponun gönderim adresi.

cutoff_time

WarehouseCutoffTime

Zorunlu. Bir siparişin kabul edilip işlenebilir hale gelmesi için geçilmesi gereken en son saat. Daha sonra verilen siparişler ertesi gün işlenir. Saat, deponun posta koduna göre belirlenir.

handling_days

int64

Zorunlu. Bu deponun bir ürünü paketleyip göndermesi için gereken gün sayısı. Bu değer depo düzeyindedir ancak bir öğenin özelliklerine göre teklif düzeyinde geçersiz kılınabilir.

business_day_config

BusinessDayConfig

Deponun iş günleri. Ayarlanmazsa varsayılan olarak Pazartesi-Cuma arası olur.

WarehouseBasedDeliveryTime

Teslimat süresinin, seçilen kargo şirketinin ayarlarına göre depo (gönderim kaynağı konumu) başına hesaplanması gerektiğini belirtir. Ayarlandığında delivery_time alanında nakliye süresiyle ilgili başka bir alan ayarlanmamalıdır.

Alanlar
carrier

string

Zorunlu. Operatör ("UPS" veya "Fedex" gibi). desteklenen operatörler

carrier_service

string

Zorunlu. "ground" veya "2 days" gibi operatör hizmeti. Hizmetin adı eddSupportedServices listesinde olmalıdır.

warehouse

string

Zorunlu. Depo adı. Bu, [warehouse][ShippingSetting.warehouses.name] ile eşleşmelidir.

WarehouseCutoffTime

Bir siparişin kabul edilip işlenebilir hale gelmesi için geçilmesi gereken en son saat. Daha sonra verilen siparişler ertesi gün işlenir. Saat, deponun posta koduna göre belirlenir.

Alanlar
hour

int32

Zorunlu. Deponun aynı gün işleme alması için siparişin verilmesi gereken son saat. Saat, deponun saat dilimine göre belirlenir.

minute

int32

Zorunlu. Depo tarafından aynı gün içinde işlenebilmesi için siparişin verilmesi gereken son sipariş saatinin dakikası. Dakika, deponun saat dilimine göre belirlenir.