Package google.shopping.merchant.promotions.v1beta

Dizin

PromotionsService

Ürünlerin tanıtımlarını yönetmek için kullanılan hizmet.

GetPromotion

rpc GetPromotion(GetPromotionRequest) returns (Promotion)

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

Bir promosyon girişi ekledikten veya güncelledikten sonra güncellenen promosyonun alınabilmesi 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'a Genel Bakış başlıklı makaleyi inceleyin.

InsertPromotion

rpc InsertPromotion(InsertPromotionRequest) returns (Promotion)

Merchant Center hesabınız için bir promosyon ekler. Promosyon zaten mevcutsa promosyon güncellenir.

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.

ListPromotions

rpc ListPromotions(ListPromotionsRequest) returns (ListPromotionsResponse)

Merchant Center hesabınızdaki promosyonları listeler. Yanıt, pageSize tarafından belirtilenden daha az öğe içerebilir. İstenecek başka öğe olup olmadığını belirlemek için pageToken değerini kullanın.

Bir promosyon eklendikten veya güncellendikten sonra, güncellenmiş ve işlenmiş promosyonun alınabilmesi 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'a Genel Bakış başlıklı makaleyi inceleyin.

Özellikler

Özellikler.

Alanlar
product_applicability

ProductApplicability

Zorunlu. Promosyonun tüm ürünler veya yalnızca belirli ürünler için geçerli olup olmadığı.

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 teklif kullanma kodu. offerType alanıyla birlikte kullanılmalıdır ve minimum koşulları karşılamalıdır.

long_title

string

Zorunlu. Promosyonun uzun başlığı.

coupon_value_type

CouponValueType

Zorunlu. Yürüttüğünüz promosyonun türünü gösteren 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 değerlerini 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 filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu 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 promosyona uygun ürünler ürün uygunluğu 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 kimliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünlerde ürün uygunluğu [product_applicability] özelliğinin specific_products olarak ayarlandığı durumlarda kullanılabilir.

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 promosyona uygun ürünler ürün uygunluğu 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 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.

brand_exclusion[]

string

İsteğe bağlı. Promosyon için marka hariç tutma özelliğine göre ürün filtresi. Ürün filtresi özellikleri yalnızca promosyona uygun ürünler ürün uygunluğu 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 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çerli olur.

product_type_exclusion[]

string

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

minimum_purchase_amount

Price

İsteğe bağlı. Promosyon için 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 indirim yüzdesi.

money_off_amount

Price

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

get_this_quantity_discounted

int64

İsteğe bağlı. Promosyonda indirim uygulanan öğelerin sayısı. Özellik, couponValueType buy_m_get_n_money_off veya buy_m_get_n_percent_off'ye eşit 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 tarihlerinin temsili. Bu özellik, promosyonun bu süre zarfında online mağazanızda test edilebileceğini belirtir.

promotion_display_time_period

Interval

İsteğe bağlı. TimePeriod promosyonun gösterim tarihlerinin temsili. Bu özellik, promosyonun Google.com'da ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını belirtir. Promosyon gösterim dönemi promotion_display_time_period özelliği belirtilmemişse promosyonun Google.com ve Alışveriş reklamlarında yayınlanacağı tarihi ve zaman aralığını promosyon geçerlilik dönemi promotion_effective_time_period özelliği 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 uygunluğu eklenmezse yerel envanter reklamı promosyonları hata verir. store_applicability, ALL_STORES olarak ayarlanırsa ve store_codes_inclusion veya score_code_exclusion bir değere ayarlanırsa INVALID_ARGUMENT hatası atılır.

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 veri 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 dahil edilmezse 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ğeri türünün belirtilmediğini gösterir.
MONEY_OFF İndirim kuponu değer türü.
PERCENT_OFF İndirim yüzdesi kupon değeri türü.
BUY_M_GET_N_MONEY_OFF M satın aldığınızda N indirim kazanın kupon değeri türü. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. money_off_amount da mevcut olmalıdır.
BUY_M_GET_N_PERCENT_OFF M satın aldığınızda yüzde N indirim kazanın kupon değeri türü. minimum_purchase_quantity ve get_this_quantity_discounted mevcut olmalıdır. percent_off_percentage da mevcut olmalıdır.
BUY_M_GET_MONEY_OFF M satın aldığınızda indirim kazanın. minimum_purchase_quantity ve money_off_amount mevcut olmalıdır.
BUY_M_GET_PERCENT_OFF M miktarda satın alın, 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 Hediye öğe kodu.
FREE_SHIPPING_STANDARD Standart ücretsiz kargo kupon değeri türü.
FREE_SHIPPING_OVERNIGHT Sonraki iş günü teslim ücretsiz kargo kupon değeri 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/{account}

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 sonuç döndürebilir. Maksimum değer 250'dir. 250'den yüksek değerler 250'ye zorlanacaktır. Belirtilmemesi durumunda maksimum promosyon sayısı döndürülür.

page_token

string

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

Sayfalandırma yapılırken ListPromotions parametresine 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 hesaptaki işlenmiş promosyonlar.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar 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 teklif türü. offerType = GENERIC_CODE olduğunda promosyon için genel teklif kullanma kodu gereklidir.

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 fazla 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:

Bir promosyon girişi ekledikten ve güncelledikten sonra nihai promosyonun alınabilmesi 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 promosyon kimliği sağladı. Promosyonların reddedilmesini önlemek için minimum koşulları yerine getirin.

content_language

string

Zorunlu. Promosyon için iki harfli ISO 639-1 dil kodu.

Promosyonlar yalnızca belirli dillerde kullanılabilir.

target_country

string

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

Promosyonlar yalnızca belirli ülkelerde kullanılabilir. Ücretsiz listelemeler ve Alışveriş reklamları Yerel envanter reklamları

redemption_channel[]

RedemptionChannel

Zorunlu. Promosyonun kullanım 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ış. Promosyonun durumu, veri doğrulama sorunları, yani bir promosyonla ilgili bilgiler eşzamansız olarak hesaplanır.

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 mevcut sürüm numarasından düşük olduğunda kampanyanın eklenmesi engellenir. Yeniden ekleme (ör. 30 gün sonra promosyonu yenileme) mevcut version_number ile yapılabilir.

İşlem engellenirse iptal edilen istisna atılı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 ilişkili sorunların listesi.

creation_date

Timestamp

Yalnızca çıkış. Promosyonun oluşturulduğu tarih (ISO 8601 biçiminde): 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 en son güncellendiği tarih (ISO 8601 biçiminde): 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 hedefine ait ad.

status

State

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

Eyalet

Promosyonun mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen promosyon durumu.
IN_REVIEW Promosyon inceleniyor.
REJECTED Promosyon onaylanmadı.
LIVE Promosyon onaylanmış ve etkin olmalıdır.
STOPPED Promosyon satıcı tarafından durduruldu.
EXPIRED Promosyon artık etkin değil.
PENDING Promosyon durdurulmamış ve tüm incelemeler onaylanmış ancak etkin tarih gelecekte.

ItemLevelIssue

Promosyonla ilişkili 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 olarak kısa bir sorun açıklaması.

detail

string

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

documentation

string

Yalnızca çıkış. Bu sorunun çözülmesine yardımcı olacak bir web sayfasının URL'si.

applicable_countries[]

string

Yalnızca çıkış. Sorunun teklif için 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 Promosyon, sıralaması düşürülür ve büyük olasılıkla arama sonuçlarında sınırlı performans gösterir.
DISAPPROVED Sorun nedeniyle promosyon onaylanmıyor.

RedemptionChannel

Promosyonun kanalı.

Sıralamalar
REDEMPTION_CHANNEL_UNSPECIFIED Kanalın belirtilmediğini 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 hangi mağaza kodları için geçerli olduğu bilinmiyor.
ALL_STORES Promosyon tüm mağazalar için geçerlidir.
SPECIFIC_STORES Promosyon yalnızca belirtilen mağazalar için geçerlidir.