Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Medya feed'i, kataloğunuzdaki medya içeriğini (ör. TV dizileri, filmler, şarkılar, albümler) temsil eden bir varlık koleksiyonu içeren bir JSON nesnesidir. İlk katılım sürecinin ilk adımı, feed'lerinizi geliştirmeye başlamaktır. Dosyalar hazır olduğunda Google'ın düzenli olarak getirmesi için desteklenen barındırma yöntemlerinden birini kullanarak feed'i barındırmanız gerekir.
Feed dosyası biçimi şartları
Feed dosyaları için gerekenler şunlardır:
Feed dosyası .json dosya adı uzantısına sahip 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ış) dosyayı birden fazla dosyaya bölün.
Her varlık türü için bir dosya oluşturmanızı öneririz (örneğin, tvseries.json, tvseasons.json, tvepisodes.json, movies.json vb.).
Bu dosyalardan herhangi biri 1 GB'ı aşıyorsa öğelerini birden fazla dosyaya bölün (örneğin, tvepisodes_01.json, tvepisodes_02.json vb.).
Dosya boyutu 1 GB'tan küçük olduğu sürece tek bir dosyaya kaç öğe ekleyeceğinizle ilgili bir sınırlama yoktur.
Dosyanın, JSON spesifikasyonuna uygun olarak BOM olmadan kodlandığından emin olun. Linux işletim sisteminde kontrol etmek için hexdump file.json | head -n 1, 0x00 adresinde BBEF ile başlamamalıdır.
Feed türleri
Üretim feed'i
Bu, Google'da yayınlamak istediğiniz kataloğunuzun tamamını temsil eden JSON feed dosyası grubunu temsil eder. Aşağıdaki bölümde feed oluşturmayı öğrenebilirsiniz.
Google ile ilk kez entegrasyon yapıyorsanız ihtiyacınız olan tek feed budur.
Bu feed Google'a gönderildikten sonra, son olarak beslenip kullanıma sunulmadan önce yakalanan bilgi miktarı ve doğruluğu açısından daha yüksek bir kalite standardına ulaşmak için kapsamlı bir şekilde analiz edilir ve birkaç kez iterasyon uygulanır.
Hazırlık feed'i
Üretim feed'inin genişletilmesini gerektiren belirli kullanım alanları vardır. Bu tür senaryolara örnek olarak şunlar verilebilir:
Feed'in, daha önce kullanıma sunulmamış yeni öğe türlerini içerecek şekilde genişletilmesi.
Feed'in, yeni yerel ayarlarda kullanıma sunulacak çok sayıda yeni öğe/meta veri içerecek şekilde genişletilmesi.
Feed'in yeni platform türlerini içerecek şekilde genişletilmesi. Örneğin, üretim feed'i yalnızca Google Arama'da kullanıma sunulmuşsa ve şimdi Google TV'de de kullanıma sunmak istiyorsanız.
Bu gibi durumlarda bir hazırlık feed'i gereklidir. Bu feed, üretim feed'inin bir kopyasıdır. Bununla birlikte, yeni bir platform için derin bağlantılar, yeni bir yerel ayar için meta veriler vb. gibi ek meta veriler içerir.
Üretim feed'ine benzer şekilde, yakalanan bilgi miktarı ve doğruluğu açısından daha yüksek bir kalite standardına ulaşmak için bu feed kapsamlı bir şekilde analiz edilir ve birkaç kez iterasyon uygulanır.
Kalite standardına ulaşıldığında bu feed, mevcut üretim feed'inin yerini alarak yeni üretim feed'i olur.
Bu feed, ilk lansmanı ek lansmanlardan ayırmamıza ve üretim feed'ini etkilemeden gerekli tüm testleri yapmamıza olanak tanır. Bu sayede son kullanıcı deneyiminde kesinti yaşanmaz.
Yukarıdakilerle ilgili kafanıza takılan soruları Google temsilcinizle görüşün.
Feed dosyası oluşturma
Feed'i oluştururken aşağıdaki en iyi uygulamaları uygulayın:
Kataloğunuzdaki tüm içeriği içeren bir feed oluşturmadan önce, yalnızca küçük bir öğe grubu içeren bir örnek feed oluşturmanızı öneririz. Özet akışınız üzerinde çalışırken sorunlarla karşılaşabilirsiniz. Varlık kümesinin boyutunu sınırlandırarak bu hata ve uyarılarda daha kolay hata ayıklama yapabilirsiniz.
Feed'inizin spesifikasyonlara uygun olmasını sağlayan araçlar sunuyoruz. Örnek feed'inizdeki tüm hata ve uyarıları çözmek için bu araçları kullanmanızı öneririz.
Küçük öğe grubunuzun iyi bir yapıya sahip olduğunu doğruladıktan sonra katalogunuzun tamamı için bir feed geliştirin.
Örnek feed oluşturma
Kataloğunuzdan temsili bir öğe seçin. Yeterince karmaşık bir yapıya sahip ancak katalogdaki bir varlık için yine de tipik olan bir varlık seçin.
Söz dizimi hatalarını ve eksik zorunlu ö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, bir örnek feed'i Google'ın medya feed'leri için yapılandırılmış veri spesifikasyonlarıyla doğrulamanıza yardımcı olur.
Veri Feed'i Doğrulama aracı
Veri feed'i doğrulama aracı, aynı anda tek bir öğeyi doğrulayabilir. Kataloğunuzdaki bir örnek öğeyi yapısal hatalar ve yaygın içerik hataları açısından doğrulamak için bu aracı kullanın. Kaldırma isteği aracı hakkında daha fazla bilgiyi burada bulabilirsiniz.
JSON Şeması Doğrulama Aracı
JSON Şeması Doğrulama aracı, feed'deki tüm dosyaları doğrulayabilir. Sık karşılaşılan yapısal hataları önlemek için feed'in geliştirilmesi sırasında bu aracı kullanın. Araç hakkında daha fazla bilgiyi burada bulabilirsiniz.
Üretim feed'i oluşturma
Örnek feed'deki tüm hatalar ve uyarılar giderildikten sonra feed'i, kataloğunuzdaki tüm öğeleri içerecek şekilde genişletin.
Feed'inizdeki az sayıda öğeyi aynı anda doğrulamak için Veri feed'i doğrulama aracını sık sık kullanın (Aracıya çok sayıda öğe yapıştırmak web tarayıcısını dondurabilir). Feed'inizdeki öğe sayısını katalogunuzdaki öğe sayısıyla karşılaştırarak feed'inizin katalogunuzdaki tüm öğeleri içerdiğini doğrulayın.
[null,null,[],[[["\u003cp\u003eThe Media feed is a JSON object that contains media content, and onboarding begins with developing and hosting these feeds.\u003c/p\u003e\n"],["\u003cp\u003eFeed files must be in \u003ccode\u003e.json\u003c/code\u003e format, UTF-8 encoded without BOM, unencrypted, and potentially split into multiple files if exceeding 1GB.\u003c/p\u003e\n"],["\u003cp\u003eTwo types of feeds exist: Production feed for initial launch of your entire catalog and Staging feed for subsequent expansions or new platform integrations.\u003c/p\u003e\n"],["\u003cp\u003eBefore creating a full production feed, it is recommended to start with a sample feed, validate it using provided tools, and then expand it to include your entire catalog.\u003c/p\u003e\n"]]],["The initial step in onboarding is developing media feeds, which are JSON files representing your catalog's content. Once developed, these files must be hosted for regular Google fetching. Feed files must be in `.json` format, UTF-8 encoded, unencrypted, and under 1GB (uncompressed); splitting larger files is recommended. Two types exist: production (for initial launch) and staging (for expansion), both are validated and iterated. You should start with a small sample feed for validation, then use tools to validate it, and expand to a production feed.\n"],null,["# Create a feed\n\nThe Media feed is a JSON object that contains a collection of entities that represent the\nmedia content in your catalog, such as TV Series, Movies, Songs, Albums, and more. The first step in\nthe onboarding process is to start developing your feeds. Once the files are ready, you need to [host](./host-the-feed)\nthe feed using one of the supported hosting methods for Google to fetch regularly.\n| **Note:** If you haven't gathered all the required information for your content, see the [Collect Information](../collect-information/) section.\n\nFeed file format requirements\n-----------------------------\n\nThe following are the requirements for the feed file(s):\n\n- Feed file must have the filename extension `.json`.\n- Don't encrypt your feed file.\n- Encode your feed file in UTF-8 (check your file editor setting).\n\n- Split the file into multiple files if your feed file is larger than 1 GB (uncompressed).\n\n- We recommend you create a file per entity type (for example, `tvseries.json`, `tvseasons.json`, `tvepisodes.json`, `movies.json`, etc).\n\n - If any of these files exceeds 1GB, split its entities into multiple files (for example, `tvepisodes_01.json`, `tvepisodes_02.json`, etc).\n - As long as the file size is less than 1 GB, there is no limitation on how many entities you can include in a single file.\n- Ensure that the file is encoded **without** BOM, as per [JSON specification](https://tools.ietf.org/html/rfc7159#section-8.1). To check on a linux OS, `hexdump file.json | head -n 1` must not start with `BBEF` at address 0x00.\n\nTypes of feeds\n--------------\n\n### Production feed\n\n- This represents the set of json feed file(s) that together represent your entire catalog you want to launch on Google. You can learn how to create a feed in the section below.\n- This is the only feed you need if you are integrating with Google for the first time.\n- Once this feed is submitted to Google, it will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness before it is finally ingested and launched.\n\n### Staging feed\n\n- There are certain use cases that require the expansion of the production feed. A few examples of such scenarios are:\n - Expansion of the feed to include new entity types, not previously launched.\n - Expansion of the feed to include a huge number of new entities/metadata to launch in new locales.\n - Expansion of the feed to new platform types. For example, when the production feed is only launched on Google Search and now you want to expand the launch to Google TV.\n- In such cases, a staging feed is required. This feed is a copy of the production feed except that it has additional metadata, for example, deep links for a new platform, metadata for a new locale and so on.\n- Similar to the production feed, this will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness. Once the quality bar is achieved, this feed replaces the current production feed to become the new production feed.\n- This feed allows us to separate the initial launch from the additional launches, perform all required testing, without affecting the production feed. This ensures no disruptions to the end user experience.\n\nWork with your Google representative to clarify any questions you may have on the above.\n\nCreate a feed file\n------------------\n\nFollow these best practices when creating the feed:\n\n1. [Create a sample feed using a small set of entities](#create_a_sample_feed)\n\n Before building a feed that contains all the content in your catalog, we recommend you create a\n sample feed with only a small set of entities. While working on your feed, you're likely to run into\n issues. By limiting your the size of the set of entities, you will be able to debug these errors and\n warnings more easily.\n2. [Validate the sample feed](#validate_the_sample_feed)\n\n We provide tools that ensure that your feed is compliant with the specifications. We recommend\n you use these tools to resolve all the errors and warnings found in your sample feed.\n3. [Create a production feed](#create_a_production_feed)\n\n After you've verified that you have a good structure for the small set of your entities, develop a feed for your entire catalog.\n\n### Create a sample feed\n\n1. Select one representative entity from your catalog. Choose an entity with a reasonably complex structure, but is still typical for an entity in the catalog.\n 2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) to check for syntax errors and missing required properties. (See the next section for details.) Example of a feed with a single `Movie` entity \n\n ```carbon\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"DataFeed\",\n \"dateModified\": \"2018-07-20T00:44:51Z\",\n \"dataFeedElement\": [\n {\n \"@context\": [\"http://schema.org\", {\"@language\": \"en\"}],\n \"@type\": \"Movie\",\n \"@id\": \"http://www.example.com/my_favorite_movie\",\n \"url\": \"http://www.example.com/my_favorite_movie\",\n \"name\": \"My Favorite Movie\",\n \"potentialAction\": {\n \"@type\": \"WatchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"http://www.example.com/my_favorite_movie?autoplay=true\",\n \"inLanguage\": \"en\",\n \"actionPlatform\": [\n \"http://schema.org/DesktopWebPlatform\",\n \"http://schema.org/MobileWebPlatform\",\n \"http://schema.org/AndroidPlatform\",\n \"http://schema.org/AndroidTVPlatform\",\n \"http://schema.org/IOSPlatform\",\n \"http://schema.googleapis.com/GoogleVideoCast\"\n ]\n },\n \"actionAccessibilityRequirement\": {\n \"@type\": \"ActionAccessSpecification\",\n \"category\": \"subscription\",\n \"requiresSubscription\": {\n \"@type\": \"MediaSubscription\",\n \"name\": \"Example Package\",\n \"commonTier\": true,\n \"@id\": \"[partner determined string]\"\n },\n \"availabilityStarts\": \"2018-07-21T10:35:29Z\",\n \"availabilityEnds\": \"2019-10-21T10:35:29Z\",\n \"eligibleRegion\": [\n {\n \"@type\": \"Country\",\n \"name\": \"US\"\n },\n {\n \"@type\": \"Country\",\n \"name\": \"CA\"\n }\n ]\n }\n },\n \"sameAs\": \"https://en.wikipedia.org/wiki/my_favorite_movie\",\n \"releasedEvent\": {\n \"@type\": \"PublicationEvent\",\n \"startDate\": \"2008-01-20\",\n \"location\": {\n \"@type\": \"Country\",\n \"name\": \"US\"\n }\n },\n \"description\": \"This is my favorite movie.\",\n \"actor\": [\n {\n \"@type\": \"Person\",\n \"name\": \"John Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/John_Doe\"\n },\n {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/Jane_Doe\"\n }\n ],\n \"identifier\": [\n {\n \"@type\": \"PropertyValue\",\n \"propertyID\": \"IMDB_ID\",\n \"value\": \"tt0123456\"\n }\n ]\n }\n ]\n }\n ```\n\n### Validate the sample feed\n\nThe following tools are available to help you validate a sample feed with Google's structured data\nspecifications for media feeds.\n\n- **Data Feed Validation tool**\n\n The Data Feed Validation tool can validate a single entity at a time. Use this tool to validate a sample\n entity from your catalog for structural errors and common content errors. You can find more\n details about the tool [here](../tools/troubleshoot-using-the-data-feed-validation-tool).\n- **JSON Schema Validation tool**\n\n The JSON Schema Validation tool can validate all files in a feed. Use this tool during the\n development of the feed to avoid common structural errors. You can find more details about the\n tool [here](../tools/jsonschemas).\n\n### Create a production feed\n\n1. Once all the errors and warnings in the sample feed are resolved, expand the feed to include all the entities in your catalog.\n2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) frequently to validate a small number of entities in your feed at a time (Pasting a large number of entities on the tool may freeze the web browser). Confirm that your feed includes all the entities in your catalog by comparing the number of entities in your feed with the number of items in your catalog."]]
