Medya feed'i, aşağıdakileri temsil eden varlıkların koleksiyonunu içeren bir JSON nesnesidir: Kataloğunuzdaki TV Dizisi, Filmler, Şarkılar, Albümler ve daha fazlası gibi medya içeriği. Projenin yaşam döngüsünün feed'lerinizi oluşturmaya başlamaktır. Dosyalar hazır olduğunda barındırmanız gerekir Google'ın düzenli olarak getirmesi için desteklenen barındırma yöntemlerinden birini kullanarak feed'inizi.
Feed dosya biçimi gereksinimleri
Feed dosyaları için gereksinimler şunlardır:
- Feed dosyasının dosya adı uzantısı
.json
olmalıdır. - Feed dosyanızı şifrelemeyin.
Feed dosyanızı UTF-8 olarak kodlayın (dosya düzenleyici ayarınızı kontrol edin).
Feed dosyanız 1 GB'tan büyükse (sıkıştırılmamış olarak) dosyayı birden fazla dosyaya bölebilirsiniz.
Öğe türüne göre (örneğin,
tvseries.json
,tvseasons.json
,tvepisodes.json
,movies.json
vb.) bir dosya oluşturmanızı öneririz.- Bu dosyalardan herhangi birinin boyutu 1 GB'ı aşıyorsa bu dosyaların öğelerini birden fazla
dosyaları (örneğin,
tvepisodes_01.json
,tvepisodes_02.json
vb.). - Dosya boyutu 1 GB'tan küçük olduğu sürece, tek bir dosyaya kaç tane öğe ekleyebileceğinizle ilgili bir sınırlama yoktur.
- Bu dosyalardan herhangi birinin boyutu 1 GB'ı aşıyorsa bu dosyaların öğelerini birden fazla
dosyaları (örneğin,
Dosyanın JSON spesifikasyonuna göre BOM olmadan kodlandığından emin olun. Linux işletim sisteminde kontrol etmek için
hexdump file.json | head -n 1
, 0x00 adresindeBBEF
ile başlamamalıdır.
Feed türleri
Üretim feed'i
- Bu, birlikte kullandığınız tüm kataloğunuzu temsil eden json feed dosyaları grubunu temsil eder Google'da kullanıma sunmak istiyorsunuz. Nasıl feed oluşturacağınızı aşağıdaki bölümde öğrenebilirsiniz.
- Bu, Google ile ilk kez entegrasyon yapıyorsanız ihtiyacınız olan tek feed'dir.
- Bu feed Google'a gönderildikten sonra kapsamlı olarak analiz edilir ve birkaç adımda tekrarlanır. yakalanan bilgi miktarı ve alınan bilgi miktarı ile daha yüksek kalitede bir çıtaya kullanılmadan önce doğruluğu kontrol eder.
Hazırlık feed'i
- Üretim feed'inin genişletilmesini gerektiren belirli kullanım alanları vardır. Birkaç örnek
örneğin,
- Feed'in, daha önce kullanıma sunulmayan yeni öğe türlerini içerecek şekilde genişletilmesi.
- Feed'in, yeni bilgisayarlarda kullanıma sunulacak çok sayıda yeni öğe/meta veri içerecek şekilde genişletilmesi yerel ayarlar.
- Feed'in yeni platform türlerine genişletilmesi. Örneğin, üretim feed'i yalnızca ilk kez Google Arama'da başladı ve şimdi de lansmanı Google TV'de konuşacak şekilde genişletmek istiyorsunuz.
- Bu gibi durumlarda bir hazırlık feed'i gerekir. Bu feed, şunun dışında üretim feed'inin bir kopyasıdır: yeni bir platform için derin bağlantılar, yeni bir yerel ayar için meta veriler gibi ek meta veriler içerir vb.
- Üretim feed'ine benzer şekilde, bu da kapsamlı bir şekilde analiz edilecek ve birkaç kez yinelenecek. yakalanan bilgi miktarı ve doğruluğu açısından daha yüksek bir kalite çıtası ile Kalite çubuğuna ulaşıldığında, bu feed mevcut üretim feed'inin yerini alarak yeni üretim feed'i oluşturabilirsiniz.
- Bu feed, ilk lansmanı ek lansmanlardan ayırmamıza, diğer tüm lansmanları Üretim feed'ini etkilemeden gerekli testlerin yapılmasıdır. Bu sayede, oyunun sonuna kadar en iyi uygulamaları paylaşacağız.
Yukarıdaki konularla ilgili olası sorularınızı netleştirmek için Google temsilcinizle birlikte çalışın.
Feed dosyası oluşturma
Feed oluştururken aşağıdaki en iyi uygulamalardan yararlanın:
Küçük bir öğe grubu kullanarak örnek feed oluşturma
Kataloğunuzdaki tüm içeriği barındıran bir feed oluşturmadan önce, yalnızca küçük bir öğe grubu içeren örnek feed. Feed'iniz üzerinde çalışırken muhtemelen sorunları. Varlık grubunuzun boyutunu sınırlandırarak bu hataları ayıklayabilir ve kolaylaştırabilirsiniz.
-
Feed'inizin spesifikasyonlara uygun olmasını sağlayan araçlar sağlarız. Önerilerimiz: örnek feed'inizde bulunan tüm hataları ve uyarıları düzeltmek için bu araçları kullanırsınız.
-
Küçük varlık grubunuz için iyi bir yapıya sahip olduğunuzu doğruladıktan sonra tüm kataloğunuz için bir feed geliştirin.
Örnek feed oluşturma
- Kataloğunuzdan bir temsili varlık seçin. Makul düzeyde karmaşık bir yapıya sahip ancak katalogdaki bir öğe için yine de tipik olan bir varlık seçin.
- Söz dizimi hatalarını ve eksik gerekli özellikleri kontrol etmek için Veri Feed'i Doğrulama aracını kullanın. (Ayrıntılar için sonraki bölüme bakın.)
Tek bir
Movie
öğesi içeren feed örneği{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": ["http://schema.org", {"@language": "en"}], "@type": "Movie", "@id": "http://www.example.com/my_favorite_movie", "url": "http://www.example.com/my_favorite_movie", "name": "My Favorite Movie", "potentialAction": { "@type": "WatchAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
Örnek feed'i doğrulama
Aşağıdaki araçlar, Google'ın yapılandırılmış verileriyle örnek bir feed'i doğrulamanıza yardımcı olabilir. özellikleri de dahil edilir.
Veri Feed'i Doğrulama aracı
Veri Feed'i Doğrulama aracı aynı anda tek bir varlığı doğrulayabilir. Bir örneği doğrulamak için bu aracı kullanın varlıklarınızı ve genel içerik öğelerini gözden geçirin. Daha fazla araçla ilgili ayrıntıları burada bulabilirsiniz.
JSON Şeması Doğrulama aracı
JSON Şema Doğrulama aracı bir feed'deki tüm dosyaları doğrulayabilir. Bu aracı feed'in geliştirilmesini sağlar. Web sitemiz g.co/newsinitiative/labs üzerinden burada bulabilirsiniz.
Üretim feed'i oluşturma
- Örnek feed'deki tüm hata ve uyarılar çözüldükten sonra feed'i genişleterek otomatik olarak seçim yapar.
- Veri Feed'i Doğrulama aracını kullanın. doğrulamak için sık sık kontrol etmenizi sağlar (tek seferde çok sayıda araç, web tarayıcısını dondurabilir). Feed'inizin tüm öğeleri içerdiğini onaylayın kataloğunuzdaki öğeleri, feed'inizdeki öğe sayısını daha fazla bilgi edinebilirsiniz.