Package google.shopping.merchant.lfp.v1beta

Dizin

LfpInventoryService

LFP iş ortaklarının satıcı için yerel envanterleri gönderme hizmeti.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Belirtilen hedef satıcı hesabı için bir LfpInventory kaynağı ekler. Kaynak zaten mevcutsa değiştirilir. Envanterin süresi 30 gün sonra otomatik olarak dolar.

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ı makaleye bakın.

LfpSaleService

Bir satıcının satış verilerini gönderebilmesini sağlayan LFP iş ortağı hizmeti.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Belirtilen satıcı için bir LfpSale 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ı makaleye bakın.

LfpStoreService

Bir satıcı için yerel mağazaları gönderen LFP iş ortağına yönelik hizmet.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Hedef satıcı için bir mağazayı siler.

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ı makaleye bakın.

GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Bir mağazayla ilgili bilgileri getirir.

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ı makaleye bakın.

InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Hedef satıcı için bir mağaza ekler. Aynı mağaza koduna sahip bir mağaza zaten varsa yeni kodla değiştirilir.

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ı makaleye bakın.

ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Hedef satıcının mağazalarını (ListLfpStoresRequest içindeki filtreyle belirtilerek) 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ı makaleye bakın.

DeleteLfpStoreRequest

DeleteLfpStore yöntemi için mesaj isteği gönderin.

Alanlar
name

string

Zorunlu. Hedef satıcı hesabı için silinecek mağazanın adı. Biçim: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

GetLfpStore yöntemi için mesaj isteyin.

Alanlar
name

string

Zorunlu. Alınacak mağazanın adı. Biçim: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

InsertLfpInventory yöntemi için mesaj isteyin.

Alanlar
parent

string

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

lfp_inventory

LfpInventory

Zorunlu. Eklenecek envanter.

InsertLfpSaleRequest

InsertLfpSale yöntemi için mesaj isteyin.

Alanlar
parent

string

Zorunlu. LFP sağlayıcı hesabı. Biçim: accounts/{lfp_partner}

lfp_sale

LfpSale

Zorunlu. Eklenecek indirim.

InsertLfpStoreRequest

InsertLfpStore yöntemi için mesaj isteği gönderin.

Alanlar
parent

string

Zorunlu. LFP sağlayıcı hesabı biçimi: accounts/{account}

lfp_store

LfpStore

Zorunlu. Eklenecek mağaza.

LfpInventory

Satıcının yerel envanteri.

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. LfpInventory kaynağının adı. Biçim: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}

target_account

int64

Zorunlu. Envanterin gönderileceği satıcının Merchant Center Kimliği.

store_code

string

Zorunlu. Satıcının mağazasının tanımlayıcısı. InsertLfpStore aracılığıyla eklenen mağaza kodu veya İşletme Profili'ndeki mağaza kodu.

offer_id

string

Zorunlu. Sabit. Ürünün benzersiz tanımlayıcısıdır. Bir satıcı için hem envanterler hem de satışlar gönderilirse bu kimlik aynı ürün için eşleşmelidir.

Not: Satıcı aynı ürünü yeni ve ikinci el olarak satıyorsa bunların farklı kimlikleri olmalıdır.

region_code

string

Zorunlu. Ürünün satıldığı ülkenin CLDR bölge kodu.

content_language

string

Zorunlu. Öğenin iki harfli ISO 639-1 dil kodu.

price

Price

İsteğe bağlı. Ürünün geçerli fiyatı.

availability

string

Zorunlu. Ürünün bu mağazadaki stok durumudur. Kabul edilen özellik değerleri için yerel ürün envanteri verileri spesifikasyonuna bakın.

collection_time

Timestamp

İsteğe bağlı. Envanterin toplandığı zaman. Ayarlanmazsa envanterin gönderildiği zamana ayarlanır.

gtin

string

İsteğe bağlı. Ürünün Global Ticari Öğe Numarasıdır.

quantity

int64

İsteğe bağlı. Bu mağazada satılan ürün miktarı. Sıfırdan büyük veya sıfıra eşit olmalıdır.

pickup_method

string

İsteğe bağlı. Bu teklif için desteklenen teslim alma yöntemi. Değer "desteklenmiyor" olmadığı sürece bu alan pickupSla ile birlikte gönderilmelidir. Kabul edilen özellik değerleri için yerel ürün envanteri verileri spesifikasyonuna bakın.

pickup_sla

string

İsteğe bağlı. Siparişin, sipariş tarihine göre teslim alınmaya hazır olması beklenen tarihtir. pickupMethod ile birlikte gönderilmelidir. Kabul edilen özellik değerleri için yerel ürün envanteri verileri spesifikasyonuna bakın.

feed_label

string

İsteğe bağlı. Ürünün feed etiketi. Bu politika ayarlanmazsa varsayılan olarak regionCode olur.

LfpSale

Satıcı için yapılan satış.

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. LfpSale kaynağının adı. Biçim: accounts/{account}/lfpSales/{sale}

target_account

int64

Zorunlu. İndirimin gönderileceği satıcının Merchant Center Kimliği.

store_code

string

Zorunlu. Satıcının mağazasının tanımlayıcısı. API veya İşletme Profili'ndeki mağaza kodu aracılığıyla eklenmiş bir storeCode.

offer_id

string

Zorunlu. Ürünün benzersiz tanımlayıcısıdır. Bir satıcı için hem envanterler hem de satışlar gönderilirse bu kimlik aynı ürün için eşleşmelidir.

Not: Satıcı aynı ürünü yeni ve ikinci el olarak satıyorsa bunların farklı kimlikleri olmalıdır.

region_code

string

Zorunlu. Ürünün satıldığı ülkenin CLDR bölge kodu.

content_language

string

Zorunlu. Öğenin iki harfli ISO 639-1 dil kodu.

gtin

string

Zorunlu. Satılan ürünün Global Ticari Öğe Numarasıdır.

price

Price

Zorunlu. Ürünün birim fiyatı.

quantity

int64

Zorunlu. Kullanılabilir miktarın göreli değişimi. İade edilen öğeler için negatif.

sale_time

Timestamp

Zorunlu. İndirimin zaman damgası.

uid

string

Yalnızca çıkış. LfpSale için sistem tarafından oluşturulan genel olarak benzersiz kimlik.

feed_label

string

İsteğe bağlı. Ürünün feed etiketi. Bu politika ayarlanmazsa varsayılan olarak regionCode olur.

LfpStore

Satıcının mağazası. Bu değer, hedef satıcının Google İşletme Profili altındaki bir mağazayla eşleştirme yapmak için kullanılır. Eşleşen mağaza bulunamazsa mağaza koduyla gönderilen envanterler veya satışlar kullanılmaz.

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. LfpStore kaynağının adı. Biçim: accounts/{account}/lfpStores/{target_merchant}~{store_code}

target_account

int64

Zorunlu. Mağazanın gönderileceği satıcının Merchant Center kimliğidir.

store_code

string

Zorunlu. Sabit. Hedef satıcı için benzersiz olan bir mağaza tanımlayıcısı.

store_address

string

Zorunlu. Mağazanın açık adresi. Örnek: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, ABD.

gcid_category[]

string

İsteğe bağlı. Google Benim İşletmem kategori kimliği.

matching_state

StoreMatchingState

İsteğe bağlı. Yalnızca çıkış. Google İşletme Profili ile eşleşmenin durumudur. Eşleşme bulunmazsa daha fazla ayrıntı için matchingStateHint adresini ziyaret edin.

store_name

string

İsteğe bağlı. Satıcı veya mağaza adıdır.

phone_number

string

İsteğe bağlı. E.164 biçimindeki mağaza telefon numarası. Örnek: +15556767888

website_uri

string

İsteğe bağlı. Mağaza veya satıcının web sitesinin URL'sidir.

place_id

string

İsteğe bağlı. Mağaza konumunun Google yer kimliği.

matching_state_hint

string

İsteğe bağlı. Yalnızca çıkış. Eşleşmenin neden başarısız olduğuyla ilgili ipucu. Bu yalnızca matchingState=STORE_MATCHING_STATE_FAILED olduğunda ayarlanır.

Olası değerler:

  • "linked-store-not-found": Eşleştirme yapılabilecek Google İşletme Profili mağazası yok.
  • "store-match-not-found": Sağlanan LfpStore, bağlı Google İşletme Profili mağazalarından hiçbiriyle eşleştirilemedi. Merchant Center hesabı doğru şekilde bağlanmış ve Google İşletme Profili'nde mağazalar mevcut ancak LfpStore konum adresi, Google İşletme Profili mağazalarının adresleriyle eşleşmiyor. LfpStore adresini veya Google İşletme Profili mağaza adresini doğru olarak eşleşecek şekilde güncelleyin.
  • "store-match-unverified": Eşleşen Google İşletme Profili mağazası doğrulanmamış olduğundan, sağlanan LfpStore, bağlı Google İşletme Profili mağazalarının hiçbiriyle eşleştirilemedi. Doğru eşleşme için Google İşletme Profili doğrulama işlemini tamamlayın.

StoreMatchingState

LfpStore ile Google İşletme Profili'nin eşleştirildiği durum.

Sıralamalar
STORE_MATCHING_STATE_UNSPECIFIED Mağaza eşleşme durumu belirtilmedi.
STORE_MATCHING_STATE_MATCHED LfpStore, bir Google İşletme Profili mağazasıyla başarıyla eşleştirildi.
STORE_MATCHING_STATE_FAILED LfpStore, bir Google İşletme Profili mağazasıyla eşleşmiyor.

ListLfpStoresRequest

ListLfpStores yöntemi için mesaj isteyin.

Alanlar
parent

string

Zorunlu. LFP iş ortağı. Biçim: accounts/{account}

target_account

int64

Zorunlu. Mağazaların listeleneceği satıcının Merchant Center kimliği.

page_size

int32

İsteğe bağlı. Belirli bir hesap için döndürülecek maksimum LfpStore kaynak sayısı. Belirli bir hesap için mağaza sayısı pageSize değerinden azsa hizmet bu değerden daha düşük bir değer döndürür. Varsayılan değer 250'dir. Maksimum değer 1000'dir. Maksimum değerden daha yüksek bir değer belirtilirse pageSize, varsayılan olarak maksimum değere ayarlanır.

page_token

string

İsteğe bağlı. Önceki ListLfpStoresRequest çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için sayfa jetonunu sağlayın. Sayfalara ayırma işlemi sırasında, ListLfpStoresRequest için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Jeton, önceki isteğe yanıt olarak nextPageToken olarak döndürüldü.

ListLfpStoresResponse

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

Alanlar
lfp_stores[]

LfpStore

Belirtilen satıcının mağazaları.

next_page_token

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.