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 deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda sergileme fırsatı sunar.
Bu doküman, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak rezervasyonlar, etkinlikler, konaklama yerleri, ilgi çekici yerler, kişiler ve bu kategorilerin hiçbirine ait olmayan diğer içerikler gibi yeni içerikleri entegre etme talimatlarını içerir.
Entegrasyon ayrıntısı
Terminoloji
Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.
Öneri kümeleri, geliştirici iş ortaklarından kişiselleştirilmiş öneriler gösterir. Aynı geliştirici iş ortağının bir öneri grubunu içeren bir kullanıcı arayüzü görünümüdür.
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. ArticleEntity öğesi, geliştiricilerin GenericFeaturedEntity'ye kıyasla kullanıcılara bilgileri daha net bir şekilde aktarmak için daha fazla meta veri içeren çeşitli metin ve resim içerikleri sunmasına olanak tanır. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 1: Öneriler kümesinde tek bir ArticleEntity öğesinin gösterildiği 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 aktarılması gereken önemli 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ü. PersonEntity: PersonEntity bir kişiyi temsil eder. Öneriler; sağlık ve fitness, spor, flört gibi kategorilerde bir kişiyi öne çıkarmak için olabilir.
Şekil 5: Öneriler kümesinde tek bir PersonEntity'yi gösteren kullanıcı arayüzü.
Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcıları tarafından yakın zamanda etkileşimde bulunulan içerikleri gösterir. Her geliştirici iş ortağının devam kümesinde en fazla 10 varlık yayınlamasına izin verilir.
Devam içeriğiniz aşağıdaki yapıda olabilir:
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. Bu varlık, tamamlanmamış haber makalelerini veya kullanıcının kaldığı yerden tüketmeye devam etmek istediği diğer içerikleri temsil etmek için kullanılabilir. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 6. Devam kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. 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 7. Devam kümesinde tek bir RestaurantReservationEntity 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
- Sinemalarda film rezervasyonu, konser, tiyatro, imza etkinliği gibi eğlence etkinlikleri
- Rehberli turlar, müze biletleri gibi seyahat veya önemli yer rezervasyonları
- Sosyal / Seminer / Konferans rezervasyonları
- Eğitim/eğitim oturumu rezervasyonları
Şekil 8. Devam 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 9. Devam 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 10. Devam kümesinde tek bir TransportationReservationEntity 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 11. Bir Continuation kümesinde tek bir VehicleReservationEntity gösteren kullanıcı arayüzü.
Öne Çıkan kümesi, birçok geliştirici iş ortağının seçili kahramanını
GenericFeaturedEntitytek bir kullanıcı arayüzü gruplandırmasında gösteren bir kullanıcı arayüzü görünümüdür. Kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilen ve tüm öneri kümelerinin üzerinde öncelikli yerleşime sahip tek bir Öne Çıkan kümesi bulunur. Her geliştirici iş ortağının Öne Çıkanlar kümesinde, birden fazla uygulama geliştiricisine ait birçok varlık (potansiyel olarak farklı türlerde) ile, desteklenen türde tek bir varlık yayınlamasına izin verilir.GenericFeaturedEntity: GenericFeaturedEntity, Öne Çıkan Öğe'nin geliştiricilerin sunduğu tek bir popüler içerik 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 12: Öne çıkan kümedeki tek bir hero GenelFeaturedEntity kartının gösterildiği kullanıcı arayüzü
Ö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 çok 5 | En az 5 | En fazla 25 (ArticleEntity, EventEntity,
LodgingEntity, StoreEntity,
PointOfInterestEntity veya PersonEntity) |
| Devam Kümesi | En fazla 1 | En az 1 | En fazla 10 (ArticleEntity,
EventReservationEntity,
LodgingReservationEntity,
TransportationReservationEntity veya
VehicleRentalReservationEntity) |
| Öne Çıkan Küme | En fazla 1 | En az 1 | En fazla 10 (GenericFeaturedEntity) |
1. adım: Öğe verilerini sağlayın
SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Diğer kategorisi için aşağıdaki varlıkları destekleriz:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityPersonEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
Aşağıdaki grafiklerde, her tür için kullanılabilir özellikler ve gereksinimler özetlenmektedir.
GenericFeaturedEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki varlığa 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'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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 resim olabilir. Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resim üzerinde rozet yer paylaşımı)
|
|
| 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 varlığa 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 resim olabilir. Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resime yerleştirilmiş rozet yer paylaşımı)
|
|
| 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 Zorunlu | Kullanıcının bu öğeyle son etkileşimde bulunduğu zamanın milisaniye cinsinden çağ zaman damgası. Not: Bu varlık devam kümesinin bir parçasıysa bu alan zorunludur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| İlerleme Yüzdesi | Koşullu Zorunlu | Kullanıcının bugüne kadar tükettiği toplam içeriğin yüzdesi. Not: Bu varlık devam kümesinin bir parçasıysa bu alan zorunludur. |
0 ile 100 arasında (0 ve 100 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 varlığa 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 |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen epoch zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan. |
Enum: 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ğlanmışsa resmin hem üst hem de alt kısmında 24 d/sn güvenli alan olduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
| Konum - Ülke | Koşullu Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Koşullu 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ünen Adres | Koşullu 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 konumun sokak 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 dönem 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 resim olabilir. |
|
| 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 zorunlu |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de sağlanmalıdır. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Etkinlik biletinin/kartı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
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 varlığa 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 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'ne bakın. |
| Konum - Ülke | Zorunlu | Konaklamanın gerçekleştiği ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Konaklamanın gerçekleştiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görünen 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 tesisinin 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: Maksimum ~20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir. |
|
| 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'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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maksimum 50 karakter |
| AvailabilityTimeWindow - Start Time | İsteğe bağlı | Konaklama tesisinin açık/kullanılabilir olmasının beklendiği zaman damgası (milisaniye cinsinden). | Milisaniye cinsinden Unix sıfır zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | Konaklamanın açık/kullanılabilir olması beklenen milisaniye cinsinden dönem zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| 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 |
| Puan - Geçerli 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, sayının kullanıcılara nasıl gösterileceğini kontrol ediyorsa bu alanı sağlayın. Kısa ve öz bir dize kullanın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında sayının kısaltılmaması için 1 milyon gibi bir kısaltma 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önetmiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara Sayı gösterilir. |
Uzun |
| Fiyat - CurrentPrice | Koşullu olarak zorunlu | Konaklama yerinin mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de 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 bağımsız bir mağazayı (ör. restoran veya market) 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 varlığa 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 metinde üç 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) |
| 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 |
| Puan - Geçerli 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, bunun kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa bir dize 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: Ekran kısaltma mantığını kendiniz kullanmak 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 varlığa 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ğlanmışsa resmin hem üst hem de alt kısmında 24 d/sn 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: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Önemli yerin gerçekleştiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görünen 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: Maksimum ~20 karakter |
| AvailabilityTimeWindow - Start Time | İsteğe bağlı | Önemli yerin açık/kullanılabilir olmasının beklendiği zamana ait milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | Önemli yerin açık/kullanılabilir olmasının beklendiği zamana kadarki milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir. |
|
| 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Puan - 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 |
| Puan - Geçerli 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 sayının kullanıcılara nasıl gösterileceğini kontrol ediyorsa bu alanı sağlayın. Özet bir dize kullanın. Örneğin, sayı 1.000.000 ise sayının daha küçük ekran boyutlarında kısaltılmaması için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Önemli yer için verilen puanların sayısı. Not: Görüntüleme kısaltma mantığını kendiniz kullanmıyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara Sayı gösterilir |
Uzun |
| Fiyat - CurrentPrice | Koşullu olarak zorunlu |
Önemli yer için biletlerin/giriş kartlarının mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de sağlanmalıdır. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Önemli yer için biletlerin/giriş kartı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 metinde üç nokta gösterilebilir) |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
PersonEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Profil - Ad | Zorunlu | Profil adı, kimliği veya herkese açık kullanıcı adı (ör. "Can Demir", "@TeamPixel" vb.). | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metin. | Serbest metin Önerilen metin boyutu: En fazla 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulanmış rozet gibi küçük resim. | Yardım için Resim Özellikleri bölümüne bakın. |
| Başlık resmi | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim kesinlikle önerilir. 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. |
| Popülerlik - Sayı | İsteğe bağlı |
Takipçi sayısını veya popülerlik değerini belirtin (ör. "3, 7 M"). Not: Hem Sayı hem de Sayı Değeri sağlanırsa Sayı kullanılır |
Dize Önerilen metin boyutu: Sayı + etiket için toplam maksimum 20 karakter |
| Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız büyük bir sayının farklı ekran boyutları için nasıl optimize edileceğiyle ilgili mantığı işlemek istemiyorsa sayı değerini sağlayın. Hem Sayı hem de Sayı Değeri sağlanırsa Sayı kullanılır. |
Uzun |
| Popülerlik - Etiket | İsteğe bağlı | Popülerlik etiketinin ne olduğunu belirtin. Örneğin, "Beğeniler". | Dize Önerilen metin boyutu: Sayı + etiket için toplam maksimum 20 karakter |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin neyle ilgili olduğunu belirtin. Örneğin: Beğenme simgesini ve emojileri gösteren resim. 1'den fazla resim eklenebilir ancak tüm form faktörlerinde bunların hepsi gösterilmeyebilir. Not: 1:1 kare resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Derecelendirme - Maksimum değer | Zorunlu | 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 | Zorunlu | 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ı | Öğenin aldığı puanların sayısı. Not: Uygulamanız, bunun kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa bir dize 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ı | Öğenin 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ım Değeri mevcutsa kullanıcılara göstermek için Sayı öğesini kullanırız |
Uzun |
| Konum - Ülke | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görünen Adres | İsteğe bağlı | Kullanıcıya, kişinin bulunduğu veya hizmet verdiği adres gösterilir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği açık adres (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir. |
|
| 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
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 varlığa 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 |
| Rezervasyon Başlangıç Saati | Zorunlu | Rezervasyonun başlamasının beklendiği milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Konum - Ülke | Zorunlu | Restoranın bulunduğu ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Restoranın bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görünen 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 varlığa 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 |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen epoch zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| 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 Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Koşullu 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ünen Adres | Koşullu 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 konumun sokak 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: Resim kesinlikle önerilir. Rozet sağlanmışsa resmin hem üst hem de alt kısmında 24 d/sn güvenli alan olduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| 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, etkinliği 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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 resim olabilir. |
|
| 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 zorunlu |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de sağlanmalıdır. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Etkinlik biletinin/kartı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) |
| 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 |
| Puan - Geçerli 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 ve öz 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: Ekran kısaltma mantığını kendiniz kullanmak 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
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 varlığa 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ığıdır. | Serbest metin. Örneğin, "12 Aralık'taki konaklamanız" Önerilen metin boyutu: En fazla 50 karakter |
| Giriş saati | Zorunlu | Rezervasyonun check-in saatini temsil eden, milisaniye cinsinden dönem zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Çıkış saati | Zorunlu | Rezervasyonun çıkış saatini milisaniye cinsinden gösteren sıfır zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Konum - Ülke | Zorunlu | Konaklama tesisinin bulunduğu ülkedir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Konaklama yerinin bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görünen 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 tesisinin 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ğlanmışsa resmin hem üst hem de alt kısmında 24 d/sn güvenli alan bulunduğ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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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 |
| Puan - Geçerli 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, bunun kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa bir dize 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: Ekran kısaltma mantığını kendiniz kullanmak 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 zorunlu | Konaklama yerinin mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de 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 varlığa 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ığıdır. | Serbest metin. Örneğin, "SFO'dan SAN'a" Önerilen metin boyutu: En fazla 50 karakter |
| Ulaşım Türü | Zorunlu | Rezervasyon için ulaşım şekli/türü. | Enum: Uçuş, TRAIN, BUS veya FERRY |
| Kalkış Saati | Zorunlu | Kalkış saatini milisaniye cinsinden gösteren sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Varış Saati | Zorunlu | Varış zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Kalkış yeri - Ülke | İsteğe bağlı | Kalkış ülkesi. | Serbest metin Önerilen metin boyutu: Maksimum ~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 eyaleti veya ili (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış yeri - Posta kodu | İsteğe bağlı | Kalkış noktasının posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Kalkış Konumu - Semt | İsteğe bağlı | Kalkış noktasının 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: Maksimum ~20 karakter |
| Varış yeri - Şehir | İsteğe bağlı | Varış şehri. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Görünen 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 bulunduğu eyalet veya il (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 bulunduğu mahalle (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'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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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şula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de 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 metinde üç nokta gösterilebilir) |
| Ulaşım Numarası | Zorunlu | Uçuş numarası, otobüs numarası, tren numarası veya feribot/kruiz numarası. | Serbest metin |
| Uçağa Biniş Saati | Zorunlu | Rezervasyonun biniş zamanını temsil eden çağ zaman damgası (varsa) | Milisaniye cinsinden Epoch zaman damgası |
VehicleRentalReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki varlığa 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ığıdır. | Serbest metin. Örneğin, "Avis Union Square SF" Önerilen metin boyutu: En fazla 50 karakter |
| Teslim alma zamanı | Zorunlu | Rezervasyonun teslim alma zamanını temsil eden çağ zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Dönüş zamanı | İsteğe bağlı | Rezervasyonun çıkış saatini temsil eden çağ zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Teslim alma adresi - Ülke | İsteğe bağlı | Teslim alma konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Alınacağı Adres - Ş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: Maksimum ~20 karakter |
| Alınacağı Adres - 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: Maksimum ~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ı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. 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şula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de 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 aşağıdaki 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 |
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_EDUCATIONTYPE_SPORTSTYPE_MOVIES_AND_TV_SHOWSTYPE_BOOKSTYPE_AUDIOBOOKSTYPE_MUSICTYPE_DIGITAL_GAMESTYPE_TRAVEL_AND_LOCALTYPE_HOME_AND_AUTOTYPE_BUSINESSTYPE_NEWSTYPE_FOOD_AND_DRINKTYPE_SHOPPINGTYPE_HEALTH_AND_FITENESSTYPE_MEDICALTYPE_PARENTINGTYPE_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 kategorilerinin 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 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 Entegrasyon kılavuzunu izleyin bölümündeki öğelere göz atın.
- TYPE_BOOKS - Genel varlıkları kullanmadan önce EbookEntity'ye göz atın.
- TYPE_AUDIOBOOKS: Genel öğeleri kullanmadan önce AudiobookEntity'ye göz atın.
- TYPE_SHOPPING: Genel varlıkları kullanmadan önce ShoppingEntity öğesine göz atın.
- TYPE_FOOD_AND_DRINK: Genel varlıkları kullanmadan önce Gıda Entegrasyonu kılavuzundaki varlıkları inceleyin.
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 eklenir.
2. adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda (örneğin, WorkManager kullanılarak) yürütülmesi ve düzenli olarak ya da etkinlik temelinde (örneğin, kullanıcı uygulamayı her açtığında veya alışveriş sepetine ürün eklediğinde) planlanması önerilir.
AppEngagePublishClient, kümeleri yayınlamaktan sorumludur.
İstemcide kümeleri yayınlamak için aşağıdaki API'ler vardır:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishContinuationClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteContinuationClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyon için kullanılıp kullanılamadığı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 nesnelerin 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
RecommendationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenmiş öneri kümesinde depolanır.
Bir hata olması durumunda, isteğin tamamı reddedilir ve mevcut durum korunur.
publishFeaturedCluster
Bu API, FeaturedCluster nesnelerin 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
FeaturedClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Öne Çıkan Küme'de depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishContinuationCluster
Bu API, ContinuationCluster nesnesi yayınlamak için kullanılır.
Kotlin
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishContinuationCluster( new PublishContinuationClusterRequest.Builder() .setContinuationCluster( new ContinuationCluster.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
ContinuationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Devam Kümesi'nde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishUserAccountManagementRequest
Bu API, bir 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'sı | Zorunlu | İşleme derin bağlantı (ör. uygulamanın 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ğlanmamışsa 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
UserAccountManagementClusterverileri 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 tüm senaryolarda durumu belirtmek (STATUS == YAYINLANDI) entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu uygunsuz durumu kullanan kontrol panellerini doldurmak açısından çok önemlidir.
- Hiçbir içerik yayınlanmadıysa ancak entegrasyon durumu bozuk değilse (STATUS == NOT_PUBLISHED) Google, uygulamanın sağlık 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, bir kullanıcı giriş yapmadığı için yayınlanmazsa 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.
deleteContinuationCluster
Bu API, Devam Kümesi'nin içeriğini silmek için kullanılır.
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
Hizmet, isteği aldığında mevcut verileri Devam Kümesi'nden 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 isteğinin 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_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build())
Java
client.deleteClusters( new DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .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ın hizmet çağrısı yapmasına izin verilmiyor. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından daha fazla). |
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 niyeti, çok sık gönderilecek şekilde tasarlanmamıştır. Bu işlem yalnızca Etkileşim Hizmeti tarafından içeriğin eski olabileceğini (örneğin, bir hafta önce) 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()kullanarakBroadcastReceiversı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 // Trigger continuation cluster publish when PUBLISH_CONTINUATION 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)) // Register Continuation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION)) }
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 // Trigger continuation cluster publish when PUBLISH_CONTINUATION 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)); // Register Continuation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION)); }
AndroidManifest.xmldosyanı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>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Hizmet tarafından aşağıdaki intent'ler gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONBu amacı aldığınızdapublishRecommendationClustersçağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_FEATUREDBu niyeti alırkenpublishFeaturedClusterçağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_CONTINUATIONBu intent'i aldığınızdapublishContinuationClusterçağrısı başlatmanız önerilir.
Entegrasyon iş akışı
İşlem tamamlandıktan sonra entegrasyonunuzu doğrulamayla ilgili adım adım açıklamalı kılavuz için Etkileşim kurma geliştirici entegrasyonu 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 sürecinde herhangi bir sorunuz olursa engagement-developers@google.com adresiyle iletişime geçin.
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 bir doğrulama ve şirket içi inceleme gerçekleştirir. Değişiklik yapılması gerekiyorsa 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 ve Devam kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.