Package google.shopping.merchant.promotions.v1beta

Dizin

PromotionsService

Ürünlerin promosyonlarını yönetme hizmeti.

GetPromotion

rpc GetPromotion(GetPromotionRequest) returns (Promotion)

Promosyonu Merchant Center hesabınızdan alır.

Promosyon girişi ekledikten veya güncelledikten sonra, güncellenen promosyonun alınması birkaç dakika sürebilir.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
InsertPromotion

rpc InsertPromotion(InsertPromotionRequest) returns (Promotion)

Merchant Center hesabınız için promosyon ekler. Promosyon zaten mevcutsa promosyonu 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
ListPromotions

rpc ListPromotions(ListPromotionsRequest) returns (ListPromotionsResponse)

Merchant Center hesabınızdaki promosyonları listeler. Yanıt, pageSize tarafından belirtilenden daha az öğe içerebilir. İstenmesi gereken daha fazla öğe olup olmadığını belirlemek için pageToken metriğine güvenin.

Bir promosyon eklendikten veya güncelledikten sonra, güncellenen işlenmiş promosyonun alınması birkaç dakika sürebilir.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Özellikler

Özellikler.

Alanlar
product_applicability

ProductApplicability

Zorunlu. Promosyonun tüm ürünlere veya yalnızca belirli ürünlere uygulanabilirliği.
offer_type

OfferType

Zorunlu. Promosyonun türü. Müşterilerin promosyonunuzu kullanmak için kupon koduna ihtiyacı olup olmadığını belirtmek amacıyla bu özelliği kullanın.
generic_redemption_code

string

İsteğe bağlı. Promosyon için genel teklifi kullanma kodu. offerType alanıyla kullanılır ve minimum koşulları karşılamalıdır.
long_title

string

Zorunlu. Promosyonun uzun başlık.
coupon_value_type

CouponValueType

Zorunlu. Yürüttüğünüz promosyonun türünü belirtmek için kupon değeri türü özelliği. Seçilen kupon değerinin türüne bağlı olarak bazı özellikler gereklidir.
promotion_destinations[]

DestinationEnum

Zorunlu. Promosyonun geçerli olduğu hedeflerin listesi. Veri kaynağınıza desteklenen bir değer ekleyerek hedef belirtmezseniz promosyonunuz varsayılan olarak Alışveriş reklamlarında ve ücretsiz listelemelerde gösterilir.

Daha önce ürünleriniz için hedef olarak şu değerleri göndermiş olabilirsiniz: Shopping Actions, Google platformları, Yerel Google platformları. Bu değerleri temsil etmek için FREE_LISTINGS, FREE_LOCAL_LISTINGS, LOCAL_INVENTORY_ADS kullanın. Daha fazla bilgi için Promosyon hedefi başlıklı makaleyi inceleyin.
item_id_inclusion[]

string

İsteğe bağlı. Promosyon için öğe kimliğine göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
brand_inclusion[]

string

İsteğe bağlı. Promosyon için markaya göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
item_group_id_inclusion[]

string

İsteğe bağlı. Promosyon için öğe grubu koduna göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü uygunluğu [product_applicability] özelliği specific_products olarak ayarlandığında geçerlidir.
product_type_inclusion[]

string

İsteğe bağlı. Promosyon için ürün türüne göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
item_id_exclusion[]

string

İsteğe bağlı. Promosyon için öğe kimliği hariç tutma ölçütüne göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
brand_exclusion[]

string

İsteğe bağlı. Promosyon için marka hariç tutma ölçütüne göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
item_group_id_exclusion[]

string

İsteğe bağlı. Öğe grubu koduna göre ürün filtrelemesi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerli olur.
product_type_exclusion[]

string

İsteğe bağlı. Promosyon için ürün türü hariç tutma ölçütüne göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyon ürünü için uygun olan ürünler product_applicability özelliği specific_products olarak ayarlandığında geçerlidir.
minimum_purchase_amount

Price

İsteğe bağlı. Promosyonun minimum satın alma tutarı.
minimum_purchase_quantity

int64

İsteğe bağlı. Promosyon için minimum satın alma miktarı.
limit_quantity

int64

İsteğe bağlı. Promosyon için maksimum satın alma miktarı.
limit_value

Price

İsteğe bağlı. Promosyon için maksimum ürün fiyatı.
percent_off

int64

İsteğe bağlı. Promosyonda sunulan yüzde indirimi.
money_off_amount

Price

İsteğe bağlı. Promosyonda sunulan nakit indirim tutarı.
get_this_quantity_discounted

int64

İsteğe bağlı. Promosyondaki indirim yapılan öğelerin sayısı. Özellik, couponValueType değeri buy_m_get_n_money_off veya buy_m_get_n_percent_off olduğunda ayarlanır.
free_gift_value

Price

İsteğe bağlı. Promosyon için hediye değeri.
free_gift_description

string

İsteğe bağlı. Promosyon için hediye açıklaması.
free_gift_item_id

string

İsteğe bağlı. Promosyon için hediye öğe kodu.
promotion_effective_time_period

Interval

Zorunlu. TimePeriod Promosyonun geçerlilik tarihlerini temsil eder. Bu özellik, promosyonun bu dönem boyunca online mağazanızda test edilebileceğini belirtir.
promotion_display_time_period

Interval

İsteğe bağlı. Promosyonun gösterim tarihlerini temsil eden TimePeriod Bu özellik, promosyonun Google.com'da ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını belirtir. Promosyon için gösterim dönemi promotion_display_time_period özelliği belirtilmemişse promosyonun Google.com'da ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını promosyon geçerlilik dönemi promotion_effective_time_period belirler.
store_applicability

StoreApplicability

İsteğe bağlı. Promosyonun tüm mağazalar mı yoksa yalnızca belirtilen mağazalar için mi geçerli olduğu. Mağaza geçerliliği eklenmezse yerel envanter reklamı promosyonları hata verir. store_applicability ALL_STORES olarak ve store_codes_inclusion veya score_code_exclusion bir değere ayarlanırsa INVALID_ARGUMENT hatası verilir.
store_codes_inclusion[]

string

İsteğe bağlı. Promosyon için eklenecek mağaza kodları. Mağaza filtresi özellikleri yalnızca store_applicability özelliği specific_stores olarak ayarlandığında geçerlidir.

Ürünün satıldığı fiziksel mağazanın mağaza kodu (İşletme Profilinizdeki mağaza kimliği). Daha fazla bilgi için Yerel ürün envanteri verileri spesifikasyonuna bakın.
store_codes_exclusion[]

string

İsteğe bağlı. Promosyon için hariç tutulacak mağaza kodları. Mağaza filtresi özellikleri yalnızca store_applicability özelliği specific_stores olarak ayarlandığında geçerlidir.
promotion_url

string

İsteğe bağlı. Satıcının sitesinde promosyonun gösterildiği sayfanın URL'si. promotion_url eklenmezse yerel envanter reklamı promosyonları hata verir. URL, promosyonun geçerli olduğunu ve kullanılabileceğini onaylamak için kullanılır.

CouponValueType

Bir promosyonun kupon değeri türü.

Sıralamalar
COUPON_VALUE_TYPE_UNSPECIFIED Kupon değer türünün belirtilmemiş olduğunu belirtir.
MONEY_OFF İndirim kuponu değer türü.
PERCENT_OFF İndirim yüzdesi değeri türü.
BUY_M_GET_N_MONEY_OFF M tutarında satın alın, Kupon değeri türünde N indirim kazanın. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. money_off_amount bulunmalıdır.
BUY_M_GET_N_PERCENT_OFF M tutarında satın alın, yüzde N indirim kuponu değeri türü kazanın. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. percent_off_percentage bulunmalıdır.
BUY_M_GET_MONEY_OFF M adet satın alarak indirim kazanın. minimum_purchase_quantity ve money_off_amount bulunmalıdır.
BUY_M_GET_PERCENT_OFF M adet satın alarak indirim kazanın. minimum_purchase_quantity ve percent_off_percentage bulunmalıdır.
FREE_GIFT Sadece açıklama içeren hediye.
FREE_GIFT_WITH_VALUE Parasal değeri olan hediye.
FREE_GIFT_WITH_ITEM_ID Öğe kimliği bulunan hediye.
FREE_SHIPPING_STANDARD Standart ücretsiz kargo kupon değeri türü.
FREE_SHIPPING_OVERNIGHT Ertesi gün ücretsiz gönderim kuponu değer türü.
FREE_SHIPPING_TWO_DAY İki gün boyunca ücretsiz kargo kuponu değer türü.

GetPromotionRequest

GetPromotion yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak promosyonun adı. Biçim: accounts/{account}/promotions/{promotions}

InsertPromotionRequest

InsertPromotion yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Promosyonun ekleneceği hesap. Biçim: accounts/{hesap}
promotion

Promotion

Zorunlu. Eklenecek promosyon.
data_source

string

Zorunlu. Promosyon Biçiminin veri kaynağı: accounts/{account}/dataSources/{datasource}.

ListPromotionsRequest

ListPromotions yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. İşlenen promosyonların listeleneceği hesap. Biçim: accounts/{account}
page_size

int32

Yalnızca çıkış. Döndürülecek maksimum promosyon sayısı. Hizmet bu değerden daha az bir değer döndürebilir. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır. Belirtilmezse maksimum sayıda promosyon döndürülür.
page_token

string

Yalnızca çıkış. Önceki ListPromotions çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi sırasında ListPromotions öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListPromotionsResponse

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

Alanlar
promotions[]

Promotion

Belirtilen hesapta işlenen promosyonlar.
next_page_token

string

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

OfferType

Promosyonun fırsat türü.

Sıralamalar
OFFER_TYPE_UNSPECIFIED Bilinmeyen teklif türü.
NO_CODE Kod içermeyen teklif türü.
GENERIC_CODE Kod içeren fırsat türü. offerType = GENERIC_CODE olduğunda, promosyon için genel teklifi kullanma kodu gerekir.

ProductApplicability

Promosyonun geçerli olduğu ürün veya ürün listesi.

Sıralamalar
PRODUCT_APPLICABILITY_UNSPECIFIED Promosyonun hangi ürünler için geçerli olduğu bilinmiyor.
ALL_PRODUCTS Tüm ürünler için geçerlidir.
SPECIFIC_PRODUCTS Yalnızca tek bir ürün veya ürün listesi için geçerlidir.

Tanıtım

Bir promosyonu temsil eder. Daha ayrıntılı bilgi için aşağıdaki makaleleri inceleyin.

Veri doğrulama kontrollerini geçmek için gerekli promosyon girişi özellikleri genel olarak aşağıda tanımlanmıştır:

Promosyon girişi eklendikten ve güncellendikten sonra son promosyonun alınması birkaç dakika sürebilir.

Alanlar
name

string

Tanımlayıcı. Tanıtımın adı. Biçim: accounts/{account}/promotions/{promotion}
promotion_id

string

Zorunlu. Kullanıcı, promosyonu benzersiz şekilde tanımlamak için sağladığı promosyon kodudur. Promosyonların reddedilmemesi için minimum koşulları yerine getirin.
content_language

string

Zorunlu. Promosyonun iki harfli ISO 639-1 dil kodu.

Promosyonlar yalnızca belirli dillerde kullanılabilir.
target_country

string

Zorunlu. Benzersiz tanımlayıcının parçası olarak kullanılan hedef ülke. CLDR bölge kodu olarak gösterilir.

Promosyonlar yalnızca belirli ülkelerde kullanılabilir. Ücretsiz listelemeler ve Alışveriş reklamları yerel envanter reklamları.
redemption_channel[]

RedemptionChannel

Zorunlu. Promosyon için teklifi kullanma kanalı. En az bir kanal gerekiyor.
data_source

string

Yalnızca çıkış. Promosyonun birincil veri kaynağı.
attributes

Attributes

İsteğe bağlı. Promosyon özelliklerinin listesi.
custom_attributes[]

CustomAttribute

İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca, veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, API tarafından açıkça gösterilmeyen özelliklerin gönderilmesi için yararlıdır.
promotion_status

PromotionStatus

Yalnızca çıkış. Bir promosyonun durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir promosyonla ilgili bilgiler.
version_number

int64

İsteğe bağlı. Promosyonun mevcut sürümünü (güncelliğini) temsil eder. Bu sürüm, aynı anda birden fazla güncelleme yapıldığında doğru sırayı korumak için kullanılabilir.

Ayarlanırsa sürüm numarası mevcut promosyonun geçerli sürüm numarasından düşük olduğunda ekleme işlemi engellenir. Mevcut version_number ile yeniden ekleme (örneğin, promosyon 30 gün sonra yenileme) işlemi gerçekleştirilebilir.

İşlem engellenirse iptal edilen istisna uygulanır.

PromotionStatus

Promosyonun durumu.

Alanlar
destination_statuses[]

DestinationStatus

Yalnızca çıkış. Promosyon için amaçlanan hedefler.
item_level_issues[]

ItemLevelIssue

Yalnızca çıkış. Promosyonla ilgili sorunların listesi.
creation_date

Timestamp

Yalnızca çıkış. Promosyonun ISO 8601 biçiminde oluşturulduğu tarih: Tarih, saat ve ofset (ör. 2020-01-02T09:00:00+01:00 veya 2020-01-02T09:00:00Z)
last_update_date

Timestamp

Yalnızca çıkış. Promosyon durumunun ISO 8601 biçiminde en son güncellendiği tarih: Tarih, saat ve ofset (ör. 2020-01-02T09:00:00+01:00 veya 2020-01-02T09:00:00Z)

DestinationStatus

Belirtilen hedefin durumu.

Alanlar
reporting_context

ReportingContextEnum

Yalnızca çıkış. Promosyon hedefinin adı.
status

State

Yalnızca çıkış. Belirtilen hedefin durumu.

Eyalet

Promosyonun mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen tanıtım durumu.
IN_REVIEW Promosyon inceleniyor.
REJECTED Tanıtım onaylanmadı.
LIVE Promosyon onaylanmış ve etkin.
STOPPED Promosyon, satıcı tarafından durduruldu.
EXPIRED Promosyon artık etkin değil.
PENDING Promosyon durdurulmaz ve tüm incelemeler onaylanır ancak geçerlilik tarihi gelecektedir.

ItemLevelIssue

Promosyonla ilgili sorun.

Alanlar
code

string

Yalnızca çıkış. Sorunun hata kodu.
severity

Severity

Yalnızca çıkış. Bu sorunun promosyonun yayınlanmasını nasıl etkilediği.
resolution

string

Yalnızca çıkış. Sorunun satıcı tarafından çözülüp çözülemeyeceği.
attribute

string

Yalnızca çıkış. Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.
reporting_context

ReportingContextEnum

Yalnızca çıkış. Sorunun geçerli olduğu hedef.
description

string

Yalnızca çıkış. İngilizce dilinde kısa bir sorun açıklaması.
detail

string

Yalnızca çıkış. İngilizce dilinde ayrıntılı bir sorun açıklaması.
documentation

string

Yalnızca çıkış. Bu sorunun çözümüne yardımcı olacak bir web sayfasının URL'si.
applicable_countries[]

string

Yalnızca çıkış. Teklif için sorunun geçerli olduğu ülke kodlarının (ISO 3166-1 alpha-2) listesi.

Önem derecesi

Sorunun önem derecesi.

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmedi.
NOT_IMPACTED Bu sorun bir uyarı niteliğindedir ve tanıtım üzerinde doğrudan bir etkisi yoktur.
DEMOTED Tanıtımın sıralaması düşürüldü ve büyük olasılıkla arama sonuçlarındaki performansı sınırlı olacak.
DISAPPROVED Bir sorun nedeniyle promosyon onaylanmadı.

RedemptionChannel

Tanıtım kanalı.

Sıralamalar
REDEMPTION_CHANNEL_UNSPECIFIED Kanalın belirtilmemiş olduğunu gösterir.
IN_STORE Kanalın mağazada olduğunu gösterir. Bu, products için kullanılan local kanalla aynı.
ONLINE Kanalın internete bağlı olduğunu gösterir.

StoreApplicability

Promosyonun geçerli olduğu mağaza kodları veya mağaza kodlarının listesi. Yalnızca yerel envanter reklamı promosyonları için geçerlidir.

Sıralamalar
STORE_APPLICABILITY_UNSPECIFIED Promosyonun geçerli olduğu mağaza kodları bilinmiyor.
ALL_STORES Promosyon tüm mağazalar için geçerlidir.
SPECIFIC_STORES Promosyon yalnızca belirtilen mağazalar için geçerlidir.