Bu sayfa, Cloud Translation API ile çevrilmiştir.

Engage SDK Travel: Üçüncü taraf teknik entegrasyon talimatları

Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriği tüketimi ve keşfi için yeni bir sürükleyici deneyim sunan cihaz üzerinde bir yüzey oluşturuyor. Bu tam ekran deneyim, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda sergileme fırsatı sunar. Bu kılavuzda, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak seyahat ve etkinlik içeriklerini entegre etme talimatları yer almaktadır.

Entegrasyon ayrıntısı

Terminoloji

Bu entegrasyon aşağıdaki küme türlerini içerir: Öneri, Öne Çıkan, Rezervasyon ve Aramaya Devam.

Öneri kümeleri, tek bir geliştirici iş ortağının kişiselleştirilmiş seyahat ve etkinlik önerilerini gösterir. Bu öneriler kullanıcıya göre kişiselleştirilebilir veya genelleştirilebilir (ör. trend olan öğeler). Makale, etkinlik, konaklama yeri veya ilgi çekici yer önerileri göstermek için bunları kullanın.
- Öneri kümesi, ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity veya StoreEntity girişlerinden oluşabilir ancak farklı varlık türlerinin bir karışımı olamaz.
Önerileriniz aşağıdaki yapıya sahiptir:
- Öneri Kümesi: Aynı geliştirici iş ortağının bir öneri grubunu içeren kullanıcı arayüzü görünümü.
- Varlık: Bir kümedeki tek bir öğeyi temsil eden nesne. Bu entegrasyon, öneri kümesi kullanılarak gösterilecek bazı öğeler sunar:
  - ArticleEntity: ArticleEntity, seyahat ve etkinliklerle ilgili metin tabanlı içerik önerilerini temsil eder. Makaleler, blog yayınları, pazarlama içeriği, haber snippet'leri vb. için kullanılabilir.
    
    Şekil 1: Öneriler kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü.
  - EventEntity: EventEntity, gelecekte gerçekleşecek bir etkinliği temsil eder. Etkinlik başlangıç zamanı, kullanıcılara iletilmesi gereken kritik bir bilgidir.
    
    Şekil 2: Öneriler kümesinde tek bir EventEntity'yi gösteren kullanıcı arayüzü.
  - Konaklama birimi: Konaklama birimi, otel, apartman, kısa ve uzun süreli kiralık tatil evi gibi bir konaklama birimini temsil eder.
    
    Şekil 3: Öneriler kümesinde tek bir LodgingEntity'yi gösteren kullanıcı arayüzü.
  - StoreEntity: StoreEntity bir mağazayı, restoranı, kafeyi vb. temsil eder. Bir yemek mekanının veya mağazanın kullanıcılara aktarılması gereken önemli bir bilgi olduğu içerikleri vurgular.
    
    Şekil 4: Öneriler kümesinde tek bir StoreEntity'yi gösteren kullanıcı arayüzü.
  - PointOfInterestEntity: PointOfInterestEntity, benzin istasyonu, etkinlik mekanı, tema parkı, müze, turistik yer, yürüyüş parkuru gibi önemli yerleri temsil eder. Konumun, kullanıcılara iletilmesi gereken kritik bir bilgi olduğu içerikleri vurgular. Konaklama, mağaza veya yemek mekanı için kullanılmamalıdır.
    
    Şekil 5: Öneriler kümesinde tek bir PointOfInterestEntity gösteren kullanıcı arayüzü.
Rezervasyon kümesi, birden fazla geliştirici iş ortağının kullanıcılarının son etkileşimde bulunduğu içerikleri tek bir kullanıcı arayüzü gruplandırmasında gösterir. Her geliştirici iş ortağının, rezervasyon kümesinde en fazla 10 öğe yayınlamasına izin verilir.

Rezervasyon içeriğiniz aşağıdaki yapıya sahip olabilir:
- RestaurantReservationEntity: RestaurantReservationEntity, bir restoran veya kafe için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden restoran rezervasyonlarını izlemesine yardımcı olur.
  
  Şekil 6. Rezervasyon kümesinde tek bir RestaurantReservationEntity'yi gösteren kullanıcı arayüzü.
- EventReservationEntity: EventReservationEntity, bir etkinlik rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden etkinlik rezervasyonlarını izlemesine yardımcı olur. Etkinlikler aşağıdakileri içerebilir ancak bunlarla sınırlı değildir:
  - Futbol maçı rezervasyonu gibi spor etkinlikleri
  - Espor rezervasyonu gibi oyun etkinlikleri
  - Sinema rezervasyonu, konser, tiyatro, imza etkinliği gibi eğlence etkinlikleri
  - Seyahat veya önemli yer rezervasyonları (ör. rehberli turlar, müze biletleri)
  - Sosyal / Seminer / Konferans rezervasyonları
  - Eğitim / eğitim oturumu rezervasyonları
  Şekil 7. Rezervasyon kümesinde tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü.
- KonaklamaRezervasyonuÖğesi: KonaklamaRezervasyonuÖğesi, seyahat konaklama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden otel ya da kiralık yer rezervasyonlarını izlemesine yardımcı olur.
  
  Şekil 8. Rezervasyon kümesinde tek bir LodgingReservationEntity'yi gösteren kullanıcı arayüzü.
- TransportationReservationEntity: TransportationReservationEntity, herhangi bir ulaşım modu için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden uçuş, feribot, tren, otobüs, araç çağırma veya kruvaziyer rezervasyonlarını takip etmesine yardımcı olur.
  
  Şekil 9. Rezervasyon kümesinde tek bir TransportationReservationEntity'yi gösteren kullanıcı arayüzü.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity, araç kiralama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden araç kiralama rezervasyonlarını izlemesine yardımcı olur.
  
  Şekil 10. Rezervasyon kümesinde tek bir VehicleRentalReservationEntity'yi gösteren kullanıcı arayüzü.
Öne Çıkan kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağından seçilen öğeleri gösterir. Tek bir Öne Çıkan küme bulunur. Bu küme, kullanıcı arayüzünün üst kısmında, tüm Öneriler kümelerinin üzerinde öncelikli bir yerleşimle gösterilir. Her geliştirici iş ortağının, Öne Çıkanlar kümesinde en fazla 10 öğe yayınlamasına izin verilir.
- GenericFeaturedEntity: GenericFeaturedEntity, Öne Çıkan Öğe'nin geliştiricilerin en iyi içeriklerinden biri için kullanılması ve kullanıcılar için ilgi çekici ve alakalı olacak en önemli içeriği temsil etmesi bakımından Önerilen Öğe'den farklıdır.
  
  Şekil 11: GenericFeaturedEntity listesini içeren bir FeaturedCluster gösteren kullanıcı arayüzü
Arama Devam Et kümesi, kullanıcının tüm seyahat uygulamalarında son zamanlarda aradığı arama sorgularının listesini göstererek kullanıcıların önceki seyahat arama yolculuklarına devam etmelerine yardımcı olur. Küme, rezervasyonlardan sonra ve öne çıkanlar ile öneri kümelerinden önce ikinci konuma sabitlenir. Her geliştirici iş ortağının, Aramaya Devam kümesinde en fazla 3 öğe yayınlamasına izin verilir.
- PointOfInterestEntity: PointOfInterestEntity, benzin istasyonu, etkinlik mekanı, tema parkı, müze, turistik yer, yürüyüş parkuru gibi önemli yerleri temsil eder. Kullanıcının daha önce aradığı içerikleri öne çıkarır.

Ön çalışma

Minimum API düzeyi: 19

com.google.android.engage:engage-core kitaplığını uygulamanıza ekleyin:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

Özet

Tasarım, bağlı hizmet uygulamasına dayanır.

Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:

Küme türü	Küme sınırları	Bir kümedeki minimum öğe sınırları	Bir kümedeki maksimum öğe sınırları
Öneri Kümeleri	En fazla 5	En az 5	En fazla 25 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity` veya `PointOfInterestEntity`)
Rezervasyon Kümesi	En fazla 1	En az 1	En fazla 10 (`RestaurantReservationEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` veya `VehicleRentalReservationEntity`)
Öne Çıkan Küme	En fazla 1	En az 1	En fazla 10 (`GenericFeaturedEntity`)
Continue Search Cluster	En fazla 1	En az 1	En fazla 3 (`PointOfInterestEntity`)

1. adım: Öğe verilerini sağlayın

SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Seyahat ve Etkinlikler kategorisi için aşağıdaki öğeleri destekleriz:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

Aşağıdaki grafiklerde, her tür için kullanılabilen özellikler ve koşullar özetlenmiştir.

`GenericFeaturedEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Poster resimleri	Zorunlu	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun.	Yardım için Resim Özellikleri bölümüne bakın.
Başlık	İsteğe bağlı	Varlığın başlığı.	Serbest metin Önerilen metin boyutu: 50 karakter
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resim/videonun üstünde özel kullanıcı deneyimi işlemi (ör. resime yerleştirilmiş rozet) "Canlı güncelleme" Makale okuma süresi
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
İçerik Kategorileri	İsteğe bağlı	Öğedeki içeriğin kategorisini açıklayın.	Sıralamalar listesi Rehberlik için İçerik Kategorisi bölümüne bakın.

`ArticleEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Serbest metin Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun	Yardım için Resim Özellikleri bölümüne bakın.
Kaynak - Başlık	İsteğe bağlı	Yazarın, kuruluşun veya muhabirin adı	Serbest metin Önerilen metin boyutu: 25 karakterden kısa
Kaynak - Resim	İsteğe bağlı	Kaynağın resmi (ör. yazar, kuruluş, muhabir)	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resim üzerinde rozet yer paylaşımı) "Canlı güncelleme" Makale okuma süresi
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
İçerik Yayınlama Zamanı	İsteğe bağlı	Bu, içeriğin uygulamada yayınlandığı / güncellendiği zamanın milisaniye cinsinden çağ zaman damgası.	Milisaniye cinsinden Unix sıfır zaman damgası
Son Etkileşim Zamanı	Koşullu Olarak Zorunlu	Kullanıcının bu öğeyle son etkileşimde bulunduğu zamanın milisaniye cinsinden çağ zaman damgası. Not: Bu varlık rezervasyon kümesinin bir parçasıysa bu alan zorunludur.	Milisaniye cinsinden Unix sıfır zaman damgası
İlerleme Yüzdesi	Koşullu Olarak Zorunlu	Kullanıcının bugüne kadar tükettiği toplam içeriğin yüzdesi. Not: Bu varlık rezervasyon kümesinin bir parçasıysa bu alan zorunludur.	0 ile 100 arasında (bu değerler dahil) bir tam sayı.
İçerik Kategorileri	İsteğe bağlı	Öğedeki içeriğin kategorisini açıklayın.	Sıralamalar listesi Rehberlik için İçerik Kategorisi bölümüne bakın.

`EventEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Dize Önerilen metin boyutu: En fazla 50 karakter
Yerelleştirilmiş başlangıç zamanı - Zaman damgası	Zorunlu	Etkinliğin başlaması beklenen epoch zaman damgası.	Joda-Time Instant
Yerelleştirilmiş başlangıç zamanı - Saat dilimi	Zorunlu	Etkinliğin başlamasının beklendiği saat dilimi.	Joda-Time DateTimeZone
Etkinlik modu	Zorunlu	Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan.	Liste: VIRTUAL, IN_PERSON veya HYBRID
Poster resimleri	Zorunlu	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun	Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke	Koşullu Olarak Zorunlu	Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Koşullu Olarak Zorunlu	Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Koşullu Olarak Zorunlu	Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad, kullanıcıya gösterilmelidir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Etkinliğin düzenlendiği yerin açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	Etkinliğin düzenlendiği eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Etkinliğin düzenlendiği konumun posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Etkinliğin düzenlendiği mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Bitiş zamanı	İsteğe bağlı	Etkinliğin sona ermesinin beklendiği epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir.	Milisaniye cinsinden Unix sıfır zaman damgası
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir.
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Fiyat - CurrentPrice	Koşullu olarak gerekli	Etkinlik biletinin/geçişinin mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Etkinlik biletinin/geçişinin orijinal fiyatı.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
İçerik Kategorileri	İsteğe bağlı	Öğedeki içeriğin kategorisini açıklayın.	Uygun enumların listesi TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema) TYPE_DIGITAL_GAMES (Örnek: Espor) TYPE_MUSIC (Örnek: Konser) TYPE_TRAVEL_AND_LOCAL (Örnek: Tur, festival) TYPE_HEALTH_AND_FITENESS (Örnek: Yoga dersi) TYPE_EDUCATION (Örnek: Sınıf) TYPE_SPORTS (Örnek: Futbol maçı) TYPE_DATING (Örnek: buluşma) Rehberlik için İçerik Kategorisi bölümüne bakın.

`LodgingEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Dize Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri	Zorunlu	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet kullanılıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan bırakın.	Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke	Zorunlu	Konaklamanın gerçekleştiği ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Zorunlu	Konaklamanın gerçekleştiği şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Zorunlu	Kullanıcıya gösterilecek konaklama yerinin adresi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Konaklama yerinin açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	Konaklama yerinin bulunduğu eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Konaklama yerinin posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Konaklama yerinin bulunduğu mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir.
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
AvailabilityTimeWindow - Yerelleştirilmiş Başlangıç Zamanı - Zaman damgası	İsteğe bağlı	Konaklama tesisinin açık/müsait olmasının beklendiği epoch zaman damgası.	Joda-Time Instant
AvailabilityTimeWindow - Yerelleştirilmiş Başlangıç Zamanı - Saat Dilimi	İsteğe bağlı	Konaklama tesisinin açık/kullanılabilir olmasının beklendiği saat dilimi.	Joda-Time DateTimeZone
AvailabilityTimeWindow - Yerelleştirilmiş Bitiş Saati - Zaman damgası	İsteğe bağlı	Konaklama tesisinin açık/kullanılabilir olmasının beklendiği zaman damgası.	Joda-Time Instant
AvailabilityTimeWindow - Yerelleştirilmiş Bitiş Zamanı - Saat Dilimi	İsteğe bağlı	Konaklama tesisinin açık/kullanılabilir olmasının beklendiği saat dilimi.	Joda-Time DateTimeZone
Derecelendirme - Maksimum değer	İsteğe bağlı	Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Mevcut değer	İsteğe bağlı	Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Sayı	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.	Dize
Derecelendirme - Sayı Değeri	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız	Uzun
Fiyat - CurrentPrice	Koşullu olarak gerekli	Konaklama yerinin mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

`StoreEntity`

StoreEntity nesnesi, geliştirici iş ortaklarının yayınlamak istediği tek bir mağazayı (ör. seyahat deneyimiyle alakalı popüler bir restoran) temsil eder.

Özellik	Şartlar	Açıklama	Biçim
Poster resimleri	Zorunlu	En az bir resim sağlanmalıdır.	Yardım için Resim Özellikleri bölümüne bakın.
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	İsteğe bağlı	Mağazanın adı.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Konum	İsteğe bağlı	Mağazanın konumu.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama metni	İsteğe bağlı	Mağazanın promosyonunu, etkinliğini veya güncellemesini öne çıkaran açıklama metni (varsa).	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama metni ayrıntıları	İsteğe bağlı	Açıklama metni için küçük yazı metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama	İsteğe bağlı	Mağazanın açıklaması.	Serbest metin Önerilen metin boyutu: 90 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Kategori	İsteğe bağlı	Bir mağazanın kategorisi. Yemek mekanları bağlamında "Fransız", "yeni Amerikan", "ramen", "gurme" gibi mutfak türleri olabilir.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Derecelendirme - Maksimum değer	İsteğe bağlı	Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Mevcut değer	İsteğe bağlı	Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Sayı	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.	Dize
Derecelendirme - Sayı Değeri	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız	Uzun

`PointOfInterestEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Dize Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri	Zorunlu	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun	Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke	Zorunlu	Önemli yerin bulunduğu ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Zorunlu	Önemli yerin gerçekleştiği şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Zorunlu	Kullanıcıya gösterilecek önemli yerin adresi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Önemli yerin açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	İlgi çekici yerin bulunduğu eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Önemli yerin posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Önemli yerin bulunduğu mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
AvailabilityTimeWindow - Yerelleştirilmiş Başlangıç Zamanı - Zaman damgası	İsteğe bağlı	Önemli yerin açık/kullanılabilir olmasının beklendiği zaman damgası.	Joda-Time Instant
AvailabilityTimeWindow - Yerelleştirilmiş Başlangıç Zamanı - Saat Dilimi	İsteğe bağlı	Önemli yerin açık/kullanılabilir olmasının beklendiği saat dilimi.	Joda-Time DateTimeZone
AvailabilityTimeWindow - Yerelleştirilmiş Bitiş Saati - Zaman damgası	İsteğe bağlı	Önemli yerin açık/kullanılabilir olmasının beklendiği zaman damgası.	Joda-Time Instant
AvailabilityTimeWindow - Yerelleştirilmiş Bitiş Zamanı - Saat Dilimi	İsteğe bağlı	Önemli yerin açık/kullanılabilir olmasının beklendiği saat dilimi.	Joda-Time DateTimeZone
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir.
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Derecelendirme - Maksimum değer	İsteğe bağlı	Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Mevcut değer	İsteğe bağlı	Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Sayı	İsteğe bağlı	Önemli yer için verilen puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.	Dize
Derecelendirme - Sayı Değeri	İsteğe bağlı	Önemli yer için verilen puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız	Uzun
Fiyat - CurrentPrice	Koşullu olarak gerekli	Önemli yer için biletlerin/giriş kartlarının mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Önemli yer için biletlerin/giriş kartlarının orijinal fiyatı.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
İçerik Kategorileri	İsteğe bağlı	Öğedeki içeriğin kategorisini açıklayın.	Uygun enumların listesi TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (Örnek: sinema) TYPE_MEDICAL (Örnek: hastane) TYPE_EDUCATION (Örnek: okul) TYPE_SPORTS (Örnek: stadyum) Rehberlik için İçerik Kategorisi bölümüne bakın.

`RestaurantReservationEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Dize Önerilen metin boyutu: En fazla 50 karakter
Yerelleştirilmiş Rezervasyon Başlangıç Zamanı - Zaman Damgası	Zorunlu	Rezervasyonun başlaması beklenen çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Rezervasyon Başlangıç Saati - Saat Dilimi	Zorunlu	Rezervasyonun başlamasının beklendiği saat dilimi.	Joda-Time DateTimeZone
Konum - Ülke	Zorunlu	Restoranın bulunduğu ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Zorunlu	Restoranın bulunduğu şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Zorunlu	Kullanıcıya gösterilecek restoranın adresi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Restoranın açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	Restoranın bulunduğu eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Restoranın posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Restoranın bulunduğu mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Tablo boyutu	İsteğe bağlı	Rezervasyon grubundaki kişi sayısı	0'dan büyük tam sayı

`EventReservationEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Dize Önerilen metin boyutu: En fazla 50 karakter
Yerelleştirilmiş başlangıç zamanı - Zaman damgası	Zorunlu	Etkinliğin başlaması beklenen epoch zaman damgası.	Joda-Time Instant
Yerelleştirilmiş başlangıç zamanı - Saat dilimi	Zorunlu	Etkinliğin başlamasının beklendiği saat dilimi.	Joda-Time DateTimeZone
Etkinlik modu	Zorunlu	Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan.	Liste: VIRTUAL, IN_PERSON veya HYBRID
Konum - Ülke	Koşullu Olarak Zorunlu	Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Koşullu Olarak Zorunlu	Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Koşullu Olarak Zorunlu	Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad, kullanıcıya gösterilmelidir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Etkinliğin düzenlendiği yerin açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	Etkinliğin düzenlendiği eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Etkinliğin düzenlendiği konumun posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Etkinliğin düzenlendiği mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun	Yardım için Resim Özellikleri bölümüne bakın.
Yerelleştirilmiş bitiş zamanı - Zaman damgası	İsteğe bağlı	Etkinliğin sona ermesinin beklendiği epoch zaman damgası.	Joda-Time Instant
Yerelleştirilmiş bitiş zamanı - Saat dilimi	İsteğe bağlı	Etkinliğin sona ermesinin beklendiği saat dilimi.	Joda-Time DateTimeZone
Servis Sağlayıcı - Ad	İsteğe bağlı	Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir.	Serbest metin. Örneğin, etkinlik düzenleyenin/turun adı
Servis Sağlayıcı - Resim	İsteğe bağlı	Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler	İsteğe bağlı	Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir.
Rozet - Metin	İsteğe bağlı	Rozetin başlığı Not: Rozet için metin veya resim gereklidir.	Serbest metin Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim	İsteğe bağlı	Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Rezervasyon kimliği	İsteğe bağlı	Etkinlik rezervasyonunun rezervasyon kimliği.	Serbest metin
Fiyat - CurrentPrice	Koşullu olarak gerekli	Etkinlik biletinin/geçişinin mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Etkinlik biletinin/geçişinin orijinal fiyatı.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Derecelendirme - Maksimum değer	İsteğe bağlı	Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Mevcut değer	İsteğe bağlı	Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Sayı	İsteğe bağlı	Etkinliğin puanlarının sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.	Dize
Derecelendirme - Sayı Değeri	İsteğe bağlı	Etkinliğin puanlarının sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız	Uzun
İçerik Kategorileri	İsteğe bağlı	Öğedeki içeriğin kategorisini açıklayın.	Uygun enumların listesi TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema) TYPE_DIGITAL_GAMES (Örnek: Espor) TYPE_MUSIC (Örnek: Konser) TYPE_TRAVEL_AND_LOCAL (Örnek: Tur, festival) TYPE_HEALTH_AND_FITENESS (Örnek: Yoga dersi) TYPE_EDUCATION (Örnek: Sınıf) TYPE_SPORTS (Örnek: Futbol maçı) TYPE_DATING (Örnek: buluşma) Rehberlik için İçerik Kategorisi bölümüne bakın.

`LodgingReservationEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Serbest metin. Örneğin, "12 Aralık'taki konaklamanız" Önerilen metin boyutu: En fazla 50 karakter
Yerelleştirilmiş Giriş Saati - Zaman Damgası	Zorunlu	Rezervasyonun giriş zamanını temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Giriş Saati - Saat Dilimi	Zorunlu	Rezervasyon için giriş saatinin bulunduğu saat dilimi.	Joda-Time Instant
Yerelleştirilmiş Çıkış Saati - Zaman damgası	Zorunlu	Rezervasyonun çıkış saatini temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Çıkış Saati - Saat Dilimi	Zorunlu	Rezervasyon için çıkış saatinin bulunduğu saat dilimi.	Joda-Time DateTimeZone
Konum - Ülke	Zorunlu	Konaklama yerinin bulunduğu ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir	Zorunlu	Konaklama yerinin bulunduğu şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Görüntülenen Adres	Zorunlu	Kullanıcıya gösterilecek konaklama yerinin adresi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres	İsteğe bağlı	Konaklama yerinin açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet	İsteğe bağlı	Konaklama yerinin bulunduğu eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu	İsteğe bağlı	Konaklama yerinin posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle	İsteğe bağlı	Konaklama yerinin bulunduğu mahalle (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rezervasyon kimliği	İsteğe bağlı	Konaklama rezervasyonunun rezervasyon kimliği.	Serbest metin
Derecelendirme - Maksimum değer	İsteğe bağlı	Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Mevcut değer	İsteğe bağlı	Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.	Sayı >= 0,0
Derecelendirme - Sayı	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.	Dize
Derecelendirme - Sayı Değeri	İsteğe bağlı	Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız	Uzun
Fiyat - CurrentPrice	Koşullu olarak gerekli	Konaklama yerinin mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

`TransportationReservationEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Serbest metin. Örneğin, "SFO'dan SAN'a" Önerilen metin boyutu: En fazla 50 karakter
Ulaşım Türü	Zorunlu	Rezervasyonun ulaşım şekli/türü.	Enum: UÇUŞ, TREN, OTOBÜS veya Vapur
Yerelleştirilmiş Kalkış Zamanı - Zaman damgası	Zorunlu	Kalkış saatini temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Kalkış Saati - Saat Dilimi	Zorunlu	Kalkış saatinin saat dilimi.	Joda-Time DateTimeZone
Yerelleştirilmiş Varış Saati - Zaman damgası	Zorunlu	Varış saatini temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Varış Saati - Saat Dilimi	Zorunlu	Varış saatinin saat dilimi.	Joda-Time DateTimeZone
Ulaşım Numarası	Zorunlu	Uçuş numarası, otobüs numarası, tren numarası veya feribot/kruiz numarası.	Serbest metin
Yerelleştirilmiş Uçağa Biniş Saati - Zaman Damgası	Zorunlu	Rezervasyonun biniş zamanını temsil eden çağ zaman damgası (varsa)	Joda-Time Instant
Yerelleştirilmiş Uçağa Biniş Saati - Saat Dilimi	Zorunlu	Rezervasyonun biniş saatinin saat dilimi (varsa)	Joda-Time DateTimeZone
Kalkış yeri - Ülke	İsteğe bağlı	Kalkış ülkesi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - Şehir	İsteğe bağlı	Kalkış şehri.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - Görüntülenen adres	İsteğe bağlı	Kullanıcıya gösterilecek kalkış konumu.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış Konumu - Açık Adres	İsteğe bağlı	Kalkış konumunun açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - Eyalet	İsteğe bağlı	Kalkış noktasının bulunduğu eyalet veya il (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - Posta kodu	İsteğe bağlı	Kalkış yerinin posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Kalkış Konumu - Semt	İsteğe bağlı	Kalkış yerinin mahallesi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Ülke	İsteğe bağlı	Varış ülkesi.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Şehir	İsteğe bağlı	Varış şehri.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Görüntülenen adres	İsteğe bağlı	Kullanıcıya gösterilecek varış konumu.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - açık adres	İsteğe bağlı	Varış konumunun açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Eyalet	İsteğe bağlı	Varış konumunun eyaleti veya ili (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Posta kodu	İsteğe bağlı	Varış konumunun posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Mahalle	İsteğe bağlı	Varış konumunun mahallesi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Servis Sağlayıcı - Ad	İsteğe bağlı	Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir.	Serbest metin. Örneğin, Hava yolu şirketinin adı
Servis Sağlayıcı - Resim	İsteğe bağlı	Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rezervasyon kimliği	İsteğe bağlı	Ulaşım rezervasyonunun rezervasyon kimliği.	Serbest metin
Fiyat - CurrentPrice	Koşullu olarak gerekli	Rezervasyonun mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Rezervasyonun orijinal fiyatı. Kullanıcı arayüzünde üstü çizilir.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

`VehicleRentalReservationEntity`

Özellik	Şartlar	Açıklama	Biçim
İşlem Uri	Zorunlu	Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın	URI
Başlık	Zorunlu	Varlığın başlığı.	Serbest metin. Örneğin, "Avis Union Square SF" Önerilen metin boyutu: En fazla 50 karakter
Yerelleştirilmiş Teslimat Saati - Zaman damgası	Zorunlu	Rezervasyonun teslim alma zamanını temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Teslimat Saati - Saat Dilimi	Zorunlu	Rezervasyonun teslim saatinin saat dilimi.	Joda-Time DateTimeZone
Yerelleştirilmiş Dönüş Süresi - Zaman damgası	İsteğe bağlı	Rezervasyonun çıkış saatini temsil eden çağ zaman damgası.	Joda-Time Instant
Yerelleştirilmiş Dönüş Süresi - Saat Dilimi	İsteğe bağlı	Rezervasyonun çıkış saatinin saat dilimi.	Joda-Time DateTimeZone
Teslim alma adresi - Ülke	İsteğe bağlı	Teslim alma konumunun bulunduğu ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Şehir	İsteğe bağlı	Teslim alma konumunun bulunduğu şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim Alınacak Adres - Görünen Adres	İsteğe bağlı	Kullanıcıya gösterilecek teslim alma konumu.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim Alınacak Adres - Açık Adres	İsteğe bağlı	Teslim alma konumunun açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Eyalet	İsteğe bağlı	Teslim alma yerinin eyaleti veya ili (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim alınacak adres - Posta kodu	İsteğe bağlı	Teslim alma yerinin posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Mahalle	İsteğe bağlı	Teslim alma konumunun mahallesi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Ülke	İsteğe bağlı	İade konumunun bulunduğu ülke.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Şehir	İsteğe bağlı	İade konumunun bulunduğu şehir.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Görünen Adres	İsteğe bağlı	Kullanıcıya gösterilecek iade konumu.	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Açık Adres	İsteğe bağlı	İade konumunun açık adresi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Eyalet	İsteğe bağlı	İade konumunun eyaleti veya ili (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade adresi - Posta kodu	İsteğe bağlı	İade konumunun posta kodu (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Mahalle	İsteğe bağlı	İade konumunun mahallesi (varsa).	Serbest metin Önerilen metin boyutu: en fazla 20 karakter
Servis Sağlayıcı - Ad	İsteğe bağlı	Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir.	Serbest metin. Örneğin, "Avis Rent a Car"
Servis Sağlayıcı - Resim	İsteğe bağlı	Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir.	Yardım için Resim Özellikleri bölümüne bakın.
Poster resimleri	İsteğe bağlı	Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.	Yardım için Resim Özellikleri bölümüne bakın.
Açıklama	İsteğe bağlı	Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Önerilen metin boyutu: 180 karakter
Altyazı listesi	İsteğe bağlı	Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.	Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Onay kimliği	İsteğe bağlı	Araç kiralama rezervasyonunun onay kimliği.	Serbest metin
Fiyat - CurrentPrice	Koşullu olarak gerekli	Rezervasyonun mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.	Serbest metin
Fiyat - Üstü Çizili Fiyat	İsteğe bağlı	Rezervasyonun orijinal fiyatı. Kullanıcı arayüzünde üstü çizilir.	Serbest metin
Fiyat Açıklama Metni	İsteğe bağlı	Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.	Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

Resim özellikleri

Resim öğeleri için gerekli özellikler bu tabloda listelenmiştir:

En boy oranı	Minimum piksel sayısı	Önerilen piksel sayısı
Kare (1x1) Tercih edilen	300x300	1.200x1.200
Yatay (1,91x1)	600x314	1.200x628
Dikey (4x5)	480x600	960x1200

En boy oranı

Minimum piksel sayısı

Önerilen piksel sayısı

Kare (1x1)

Tercih edilen

300x300

1.200x1.200

Yatay (1,91x1)

600x314

1.200x628

Dikey (4x5)

480x600

960x1200

Google'ın görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.

Dosya biçimleri

PNG, JPG, statik GIF, WebP

Maksimum dosya boyutu

5.120 KB

Ek öneriler

Resim güvenli alanı: Önemli içeriklerinizi yatay ve dikey yönde ortalanmış olarak resmin% 80'ini kaplayacak şekilde yerleştirin.
Resmin koyu ve açık tema ayarlarında düzgün şekilde gösterilmesi için şeffaf bir arka plan kullanın.

İçerik Kategorisi

İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerik yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış kategorilerden bazılarıyla eşleştirir. Bu kategoriler şunlardır:

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

Google'ın görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.

İçerik kategorilerini kullanmayla ilgili kurallar

ArticleEntity ve GenericFeaturedEntity gibi bazı varlıklar, içerik kategorilerinden herhangi birini kullanmaya uygundur. EventEntity, EventReservationEntity, PointOfInterestEntity gibi diğer varlıklar için yalnızca bu kategorilerin bir alt kümesi uygundur. Listeyi doldurmadan önce bir varlık türü için uygun kategorilerin listesini kontrol edin.
Bazı içerik kategorileri için genel öğeler ve ContentCategory öğesinin bir kombinasyonu yerine belirli öğe türünü kullanın:
- TYPE_MOVIES_AND_TV_SHOWS: Genel varlıkları kullanmadan önce İzle entegrasyon kılavuzundaki varlıkları inceleyin.
- TYPE_BOOKS: Genel öğeleri kullanmadan önce EbookEntity'ye göz atın.
- TYPE_AUDIOBOOKS: Genel öğeleri kullanmadan önce AudiobookEntity'ye göz atın.
- TYPE_SHOPPING: Genel öğeleri kullanmadan önce ShoppingEntity'ye göz atın.
- TYPE_FOOD_AND_DRINK: Genel varlıkları kullanmadan önce Gıda Entegrasyonu Kılavuzu'ndaki varlıklara göz atın.
ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değilse boş bırakılmalıdır.
Birden fazla içerik kategorisi sağlanırsa bunları içerikle alaka düzeyine göre sıralayın. En alakalı içerik kategorisi listeye ilk sırada eklenmelidir.

2. adım: Küme verilerini sağlayın

İçerik yayınlama işinin arka planda (ör. WorkManager kullanılarak) yürütülmesi ve düzenli olarak veya etkinlik bazında (ör. kullanıcı uygulamayı her açtığında ya da sepete bir şey eklediğinde) planlanması önerilir.

AppEngageTravelClient, kümeleri yayınlamaktan sorumludur.

İstemcide kümeleri yayınlamak için aşağıdaki API'ler vardır:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

Bu API, hizmetin entegrasyon için kullanılıp kullanılamayacağını ve içeriğin cihazda sunulup sunulamayacağını kontrol etmek için kullanılır.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

`publishRecommendationClusters`

Bu API, RecommendationCluster nesnelerinin listesini yayınlamak için kullanılır.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

Geliştirici iş ortağının mevcut RecommendationCluster verileri kaldırılır.
İstekten gelen veriler ayrıştırılır ve güncellenmiş öneri kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`publishFeaturedCluster`

Bu API, FeaturedCluster nesnelerinin listesini yayınlamak için kullanılır.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

Geliştirici iş ortağının mevcut FeaturedCluster verileri kaldırılır.
İstekten gelen veriler ayrıştırılır ve güncellenen Öne Çıkan Küme'de depolanır.

Hata durumunda, isteğin tamamı reddedilir ve mevcut durum korunur.

`publishReservationCluster`

Bu API, ReservationCluster nesnesi yayınlamak için kullanılır.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

Geliştirici iş ortağının mevcut ReservationCluster verileri kaldırılır.
İstekten gelen veriler ayrıştırılır ve güncellenen rezervasyon kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`publishContinueSearchCluster`

Bu API, ContinueSearchCluster nesnelerinin listesini yayınlamak için kullanılır.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

Geliştirici iş ortağının mevcut ContinueSearchCluster verileri kaldırılır.
İstekten gelen veriler ayrıştırılır ve güncellenen Devam Et Arama Kümesi'nde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`publishUserAccountManagementRequest`

Bu API, oturum açma kartı yayınlamak için kullanılır . Oturum açma işlemi, uygulamanın içerik yayınlayabilmesi (veya daha kişiselleştirilmiş içerik sunabilmesi) için kullanıcıları uygulamanın oturum açma sayfasına yönlendirir.

Aşağıdaki meta veriler, oturum açma kartının bir parçasıdır:

Özellik	Şartlar	Açıklama
İşlem Uri	Zorunlu	İşleme derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirme)
Resim	İsteğe bağlı: Sağlanmazsa Başlık sağlanmalıdır	Kartta gösterilen resim 1264x712 çözünürlüğe sahip 16x9 en boy oranına sahip resimler
Başlık	İsteğe bağlı: Sağlanmazsa resim sağlanmalıdır	Karttaki başlık
İşlem metni	İsteğe bağlı	CTA'da Gösterilen Metin (ör. Oturum aç)
Alt başlık	İsteğe bağlı	Kartta isteğe bağlı altyazı

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

Geliştirici iş ortağının mevcut UserAccountManagementCluster verileri kaldırılır.
İstekten gelen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`updatePublishStatus`

Dahili bir işletme nedeniyle kümelerin hiçbiri yayınlanmıyorsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle tavsiye ederiz. Bu önemlidir, çünkü :

İçerik yayınlandığında bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu açık durumu kullanan kontrol panellerini doldurmak açısından çok önemlidir.
Hiçbir içerik yayınlanmamışsa ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED) Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemekten kaçınabilir. Sağlayıcı açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
Geliştiricilerin verilerin ne zaman yayınlandığı ve ne zaman yayınlanmadığı hakkında analizler sunmasına yardımcı olur.
Google, kullanıcının uygulama içeriğini görebilmesi veya bu içeriğin üstesinden gelmesi için uygulamada belirli işlemleri yapmasına yönlendirmek amacıyla durum kodlarını kullanabilir.

Uygun yayınlama durumu kodlarının listesi şunlardır :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

İçerik, kullanıcının giriş yapmaması nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Sağlayıcılar herhangi bir nedenle oturum açma kartını yayınlayamıyorsa NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla updatePublishStatus API'sini çağırmanızı öneririz.

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

Bu API, öneri kümelerinin içeriğini silmek için kullanılır.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Hizmet, isteği aldığında mevcut verileri öneri kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`deleteFeaturedCluster`

Bu API, Öne Çıkan Küme'nin içeriğini silmek için kullanılır.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Hizmet, isteği aldığında Öne Çıkan Küme'deki mevcut verileri kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`deleteReservationCluster`

Bu API, rezervasyon kümesinin içeriğini silmek için kullanılır.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Hizmet, isteği aldığında mevcut verileri rezervasyon kümesinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`deleteUserManagementCluster`

Bu API, UserAccountManagement kümesinin içeriğini silmek için kullanılır.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Hizmet, isteği aldığında mevcut verileri UserAccountManagement kümesinden kaldırır. Hata durumunda istek tamamen reddedilir ve mevcut durum korunur.

`deleteContinueSearchCluster`

Bu API, Aramaya Devam Kümesi'nin içeriğini silmek için kullanılır.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Hizmet isteği aldığında, Devam Et arama kümesinden mevcut verileri kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

`deleteClusters`

Bu API, belirli bir küme türünün içeriğini silmek için kullanılır.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .build());

Hizmet, isteği aldığında belirtilen küme türleriyle eşleşen tüm kümelerdeki mevcut verileri kaldırır. İstemciler bir veya daha fazla küme türünü iletmeyi seçebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

Hata işleme

Yayınlama API'lerinden görev sonucunu dinlemeniz önemle tavsiye edilir. Böylece, başarılı bir görevi kurtarıp yeniden göndermek için takip işlemi yapabilirsiniz.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Hata, hata kodu olarak nedeni dahil edilerek AppEngageException olarak döndürülür.

Hata kodu	Hata adı	Not
`1`	`SERVICE_NOT_FOUND`	Hizmet, belirtilen cihazda kullanılamıyor.
`2`	`SERVICE_NOT_AVAILABLE`	Hizmet, belirli bir cihazda kullanılabilir ancak arama sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır).
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	Görev yürütme, mesaj dizileriyle ilgili sorunlar nedeniyle başarısız oldu. Bu durumda, işlem yeniden denenebilir.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Arayan kullanıcının servis araması yapmasına izin verilmiyor.
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	İstek geçersiz veriler içeriyor (örneğin, izin verilenden daha fazla sayıda küme).
`6`	`SERVICE_CALL_INTERNAL`	Hizmet tarafında bir hata var.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	Servis çağrısı çok sık yapılıyor.

3. Adım: Yayın intent'lerini işleme

Bir iş aracılığıyla içerik yayınlama API çağrıları yapmanın yanı sıra, içerik yayınlama isteğini almak için bir BroadcastReceiver oluşturmanız da gerekir.

Yayın niyetinin amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın niyetleri çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca Engage Hizmeti içeriğin güncel olmayabileceğini (ör. bir haftalık) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süre çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimi yaşayabileceğinden emin olabilirsiniz.

BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:

Context.registerReceiver() kullanarak BroadcastReceiver sınıfının bir örneğini dinamik olarak kaydedin. Bu sayede, bellekte hâlâ etkin olan uygulamalardan iletişim kurulabilir.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

}

AndroidManifest.xml dosyanızda <receiver> etiketiyle uygulamayı statik olarak beyan edin. Bu, uygulamanın çalışmadığında yayın intent'leri almasına ve içeriği yayınlamasına olanak tanır.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
   </receiver>
</application>

Hizmet tarafından aşağıdaki intent'ler gönderilir:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Bu amacı aldığınızda publishRecommendationClusters çağrısı başlatmanız önerilir.
com.google.android.engage.action.PUBLISH_FEATURED Bu intent'i aldığınızda publishFeaturedCluster çağrısı başlatmanız önerilir.

Entegrasyon iş akışı

Entegrasyonunuz tamamlandıktan sonra doğrulamayla ilgili adım adım açıklamalı bir kılavuz için Engage geliştirici entegrasyon iş akışı başlıklı makaleyi inceleyin.

SSS

SSS için Engage SDK'sı hakkında sık sorulan sorular başlıklı makaleyi inceleyin.

İletişim

Entegrasyon işlemi sırasında sorularınız olursa engage-developers@google.com adresiyle iletişime geçebilirsiniz.

Sonraki adımlar

Bu entegrasyonu tamamladıktan sonra uygulayacağınız adımlar şunlardır:

engage-developers@google.com adresine e-posta gönderin ve Google tarafından test edilmeye hazır olan entegre APK'nızı ekleyin.
Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için şirket içinde bir doğrulama ve inceleme yapar. Değişiklik yapılması gerekirse Google gerekli tüm bilgileri sizinle paylaşır.
Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenmiş ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
Google, güncellenmiş APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri, Öne Çıkan, Rezervasyon ve Arama Devam Et kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.