Halaman ini diterjemahkan oleh Cloud Translation API.

Buat feed

Feed Media adalah objek JSON yang berisi kumpulan entity yang mewakili konten media dalam katalog Anda, seperti Serial TV, Film, Lagu, Album, dan lainnya. Langkah pertama dalam proses orientasi adalah mulai mengembangkan feed Anda. Setelah file siap, Anda harus menghosting feed menggunakan salah satu metode hosting yang didukung agar Google dapat mengambilnya secara rutin.

Persyaratan format file feed

Berikut adalah persyaratan untuk file feed:

File feed harus memiliki ekstensi nama file .json.
Jangan mengenkripsi file feed Anda.
Enkode file feed Anda dalam UTF-8 (periksa setelan editor file Anda).
Bagi file menjadi beberapa file jika file feed Anda lebih besar dari 1 GB (tidak dikompresi).
Sebaiknya buat file per jenis entity (misalnya, tvseries.json, tvseasons.json, tvepisodes.json, movies.json, dll.).
- Jika salah satu file ini melebihi 1 GB, bagi entitas menjadi beberapa file (misalnya, tvepisodes_01.json, tvepisodes_02.json, dll.).
- Selama ukuran file kurang dari 1 GB, tidak ada batasan jumlah entity yang dapat Anda sertakan dalam satu file.
Pastikan file dienkode tanpa BOM, sesuai dengan spesifikasi JSON. Untuk memeriksa OS Linux, hexdump file.json | head -n 1 tidak boleh diawali dengan BBEF di alamat 0x00.

Jenis feed

Feed produksi

Ini mewakili kumpulan file feed json yang bersama-sama mewakili seluruh katalog yang ingin Anda luncurkan di Google. Anda dapat mempelajari cara membuat feed di bagian bawah.
Ini adalah satu-satunya feed yang Anda perlukan jika berintegrasi dengan Google untuk pertama kalinya.
Setelah dikirimkan ke Google, feed ini akan dianalisis secara ekstensif dan di-iterasi beberapa kali untuk mencapai standar kualitas yang lebih tinggi terkait jumlah informasi yang diambil dan kebenarannya sebelum akhirnya diserap dan diluncurkan.

Feed staging

Ada kasus penggunaan tertentu yang memerlukan perluasan feed produksi. Beberapa contoh skenario tersebut adalah:
- Perluasan feed untuk menyertakan jenis entitas baru, yang sebelumnya tidak diluncurkan.
- Perluasan feed untuk menyertakan sejumlah besar entitas/metadata baru yang akan diluncurkan di lokalitas baru.
- Perluasan feed ke jenis platform baru. Misalnya, saat feed produksi hanya diluncurkan di Google Penelusuran dan sekarang Anda ingin memperluas peluncuran ke Google TV.
Dalam kasus tersebut, feed staging diperlukan. Feed ini adalah salinan feed produksi, kecuali bahwa feed ini memiliki metadata tambahan, misalnya, deep link untuk platform baru, metadata untuk lokalitas baru, dan sebagainya.
Serupa dengan feed produksi, feed ini akan dianalisis secara ekstensif dan di-iterasi beberapa kali untuk mencapai standar kualitas yang lebih tinggi terkait jumlah informasi yang diambil dan kebenarannya. Setelah standar kualitas tercapai, feed ini akan menggantikan feed produksi saat ini menjadi feed produksi baru.
Feed ini memungkinkan kita memisahkan peluncuran awal dari peluncuran tambahan, melakukan semua pengujian yang diperlukan, tanpa memengaruhi feed produksi. Hal ini memastikan tidak ada gangguan pada pengalaman pengguna akhir.

Hubungi perwakilan Google Anda untuk mengklarifikasi pertanyaan apa pun yang mungkin Anda miliki tentang hal di atas.

Membuat file feed

Ikuti praktik terbaik berikut saat membuat feed:

Membuat feed contoh menggunakan sekumpulan kecil entitas

Sebelum membuat feed yang berisi semua konten dalam katalog, sebaiknya buat feed contoh dengan hanya sekumpulan kecil entitas. Saat mengerjakan feed, Anda mungkin akan mengalami masalah. Dengan membatasi ukuran kumpulan entitas, Anda akan dapat men-debug error dan peringatan ini dengan lebih mudah.
Memvalidasi feed contoh

Kami menyediakan alat yang memastikan feed Anda mematuhi spesifikasi. Sebaiknya gunakan alat ini untuk mengatasi semua error dan peringatan yang ditemukan di feed contoh Anda.
Membuat feed produksi

Setelah memverifikasi bahwa Anda memiliki struktur yang baik untuk sekumpulan kecil entitas, buat feed untuk seluruh katalog Anda.

Membuat feed contoh

Pilih satu entitas perwakilan dari katalog Anda. Pilih entitas dengan struktur yang cukup kompleks, tetapi masih umum untuk entitas dalam katalog.

Gunakan alat Validasi Feed Data untuk memeriksa error sintaksis dan properti wajib yang tidak ada. (Lihat bagian berikutnya untuk mengetahui detailnya.)

Contoh feed dengan satu entity Movie

{
  "@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"
        }
      ]
    }
  ]
}

Memvalidasi feed contoh

Alat berikut tersedia untuk membantu Anda memvalidasi feed contoh dengan spesifikasi data terstruktur Google untuk feed media.

Alat Validasi Feed Data

Alat Validasi Feed Data dapat memvalidasi satu entitas dalam satu waktu. Gunakan alat ini untuk memvalidasi contoh entity dari katalog Anda untuk menemukan error struktural dan error konten umum. Anda dapat menemukan detail selengkapnya tentang alat ini di sini.
Alat Validasi Skema JSON

Alat Validasi Skema JSON dapat memvalidasi semua file dalam feed. Gunakan alat ini selama pengembangan feed untuk menghindari error struktural umum. Anda dapat menemukan detail selengkapnya tentang alat ini di sini.

Membuat feed produksi

Setelah semua error dan peringatan di feed contoh diselesaikan, luaskan feed untuk menyertakan semua entitas di katalog Anda.
Gunakan alat Validasi Feed Data secara rutin untuk memvalidasi sejumlah kecil entitas dalam feed Anda sekaligus (Menempelkan sejumlah besar entitas di alat ini dapat membekukan browser web). Pastikan feed Anda menyertakan semua entitas di katalog dengan membandingkan jumlah entitas dalam feed dengan jumlah item di katalog.