Feed oluşturma

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).

    alt_text

  • 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.
  • 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 adresinde BBEF 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:

  1. 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.

  2. Örnek feed'i doğrulama

    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.

  3. Üretim feed'i oluşturma

    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

  1. 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.
  2. 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

  1. Örnek feed'deki tüm hata ve uyarılar çözüldükten sonra feed'i genişleterek otomatik olarak seçim yapar.
  2. 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.