ফিড গঠন ওভারভিউ

মিডিয়া অ্যাকশন ফিড হল একটি JSON অবজেক্ট যাতে সত্তার একটি সংগ্রহ থাকে। একটি সত্তা হল একটি schema.org অবজেক্ট যা আপনার ক্যাটালগের একটি আইটেমকে উপস্থাপন করে: একটি টিভি পর্ব, একটি টিভি সিরিজ, একটি চলচ্চিত্র, একটি গান, একটি অ্যালবাম এবং আরও অনেক কিছু৷

চিত্র 1. ওয়াচ অ্যাকশন এবং লিসেন অ্যাকশনের ফিড কাঠামো।

ফিড গঠন

ওয়াচ অ্যাকশন এবং লিসেন অ্যাকশনের বিভিন্ন ফিড স্ট্রাকচার রয়েছে।

ওয়াচ অ্যাকশনগুলির নিম্নলিখিত শ্রেণিবিন্যাস রয়েছে:
 লিসেন অ্যাকশনের নিম্নলিখিত শ্রেণিবিন্যাস রয়েছে:

ডেটা ফিড খাম

একটি ডেটা ফিড খাম মিডিয়া অ্যাকশন ফিডে শীর্ষ স্তরের বস্তু। অবজেক্টটিতে কন্টেন্ট মার্কআপ অবজেক্টের (সত্তা) একটি অ্যারে রয়েছে যা আপনার ক্যাটালগের সমস্ত বিষয়বস্তুকে উপস্থাপন করে।

একটি ডেটা ফিড খাম নিম্নলিখিত বৈশিষ্ট্য সমর্থন করে:

সম্পত্তি টাইপ বর্ণনা
@context URL প্রয়োজনীয় - http://schema.org এ সেট করুন
@type পাঠ্য প্রয়োজনীয় - DataFeed এ সেট করুন।
dateModified তারিখ সময় প্রয়োজনীয় - ISO 8601 ফর্ম্যাটে (টাইমজোন সহ) ফিডের শেষ পরিবর্তিত তারিখ এবং সময়।
dataFeedElement জিনিস প্রয়োজনীয় - আপনার মিডিয়া ক্যাটালগের সত্তা ।

ডেটা ফিড খামের টেমপ্লেট

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    { <CONTENT MARKUP OBJECT 01> },
    { <CONTENT MARKUP OBJECT 02> },
    { <CONTENT MARKUP OBJECT 03> },
    ...
  ]
}

কন্টেন্ট মার্কআপ

একটি বিষয়বস্তু মার্কআপ অবজেক্ট আপনার ক্যাটালগে একটি একক সত্তাকে প্রতিনিধিত্ব করে: একটি চলচ্চিত্র, একটি টিভি পর্ব, একটি টিভি সিরিজ, একটি গান, একটি অ্যালবাম, একটি রেডিও স্টেশন, ইত্যাদি৷ বস্তুটিতে সামগ্রীর শনাক্তকারী এবং ক্যানোনিকাল URL রয়েছে এবং এর মাধ্যমে বিষয়বস্তু বর্ণনা করতে সহায়তা করে মেটাডেটা

কন্টেন্ট মার্কআপ টেমপ্লেট

একটি বিষয়বস্তু মার্কআপ অবজেক্টে অ্যাকশন মার্কআপ অবজেক্টের একটি অ্যারে থাকতে পারে, যা বিষয়বস্তুকে একাধিক অ্যাকশন মার্কআপ অবজেক্টের সাথে যুক্ত করতে দেয়। উদাহরণ স্বরূপ, বিষয়বস্তুর প্রতি অঞ্চলে আলাদা অ্যাকশন মার্কআপ অবজেক্ট থাকতে পারে।

{
   "@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": [
     { <ACTION MARKUP OBJECT 01> },
     { <ACTION MARKUP OBJECT 02> }
   ],
   ...
}

অ্যাকশন মার্কআপ

একটি অ্যাকশন মার্কআপ অবজেক্ট ডিপ লিঙ্ককে বর্ণনা করে যা ব্যবহারকারীদের বিষয়বস্তু এবং সামগ্রীর জন্য প্রয়োজনীয় অ্যাক্সেস লেভেলে নিয়ে যায়। বস্তুটি একটি বিষয়বস্তু মার্কআপ বস্তুর একটি সম্পত্তি ( potentialAction )।

অ্যাক্সেস সীমাবদ্ধতা নির্দিষ্ট করার দুটি উপায় আছে:

অ্যাকশন মার্কআপ টেমপ্লেট

বিষয়বস্তুর একাধিক গভীর লিঙ্ক থাকলে, একটি অ্যাকশন মার্কআপ অবজেক্টে একাধিক লক্ষ্যবস্তু অন্তর্ভুক্ত থাকে। উদাহরণ স্বরূপ, iOS-এর জন্য বিষয়বস্তুর গভীর লিঙ্ক অ্যান্ড্রয়েড ডিপ লিঙ্ক থেকে আলাদা হতে পারে। এছাড়াও, যদি অঞ্চল এবং সময়ের উপর ভিত্তি করে বিভিন্ন অ্যাক্সেসের সীমাবদ্ধতা থাকে, তবে একটি অ্যাকশন মার্কআপ অবজেক্টে একাধিক অ্যাকশন অ্যাক্সেস স্পেসিফিকেশন অবজেক্ট থাকতে পারে বা অফার অবজেক্ট থাকতে পারে, যেমনটি নীচের টেমপ্লেটগুলিতে দেখানো হয়েছে।

ওয়াচ অ্যাকশনের জন্য অ্যাকশন মার্কআপ অবজেক্ট টেমপ্লেট:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "actionAccessibilityRequirement": [
    { <ACTION ACCESSIBILITY OBJECT 01> },
    { <ACTION ACCESSIBILITY OBJECT 02> }
  ]
}

লিসেন অ্যাকশনের জন্য অ্যাকশন মার্কআপ অবজেক্ট টেমপ্লেট:

"potentialAction": {
  "@type": "ListenAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "expectsAcceptanceOf": [
    { <OFFER OBJECT 01> },
    { <OFFER OBJECT 02> }
  ]
}

টার্গেট

একটি টার্গেট অবজেক্ট বিভিন্ন Google প্ল্যাটফর্মে একটি গভীর লিঙ্কের ম্যাপিং প্রদান করে। বস্তুটি একটি অ্যাকশন মার্কআপ অবজেক্টের একটি সম্পত্তি ( target )।

লক্ষ্য উদাহরণ

প্ল্যাটফর্মের উপর ভিত্তি করে বিষয়বস্তুর একাধিক গভীর লিঙ্ক থাকলে, বিভিন্ন ম্যাপিং প্রদান করতে একাধিক লক্ষ্যবস্তু তৈরি করুন। উদাহরণস্বরূপ, Chromecast-এর জন্য বিষয়বস্তুর গভীর লিঙ্ক অন্যান্য প্ল্যাটফর্মের গভীর লিঙ্কগুলির থেকে আলাদা হতে পারে, যেমনটি নীচের উদাহরণে দেখানো হয়েছে৷

একটি লক্ষ্য বস্তুর উদাহরণ (মৌলিক):

"target": {
  "@type": "EntryPoint",
  "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
  "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"
  ]
}

দুটি গভীর লিঙ্ক সহ লক্ষ্য বস্তুর উদাহরণ:

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/MobileWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/cast/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.googleapis.com/GoogleVideoCast"
    ]
  }
]

অ্যাকশন অ্যাক্সেস স্পেসিফিকেশন

একটি অ্যাকশন অ্যাক্সেস স্পেসিফিকেশন অবজেক্ট অঞ্চল এবং সময়ের উপর ভিত্তি করে সামগ্রীর অ্যাক্সেসের প্রয়োজনীয়তা বর্ণনা করে। বস্তুটি একটি অ্যাকশন মার্কআপ অবজেক্টের একটি সম্পত্তি, actionAccessibilityRequirement ।

অবজেক্টের category নিচের যেকোনো একটি হতে পারে:

মিডিয়া সাবস্ক্রিপশন

একটি মিডিয়া সাবস্ক্রিপশন অবজেক্ট কন্টেন্টের জন্য প্রয়োজনীয় সাবস্ক্রিপশনের বিশদ বর্ণনা করে। বস্তুটি একটি অ্যাকশন অ্যাক্সেস স্পেসিফিকেশন অবজেক্টের একটি সম্পত্তি, requiresSubscription । যদি actionAccessibilityRequirement.category subscription বা externalSubscription হয় এবং আপনার সাবস্ক্রিপশন অফারে একাধিক প্যাকেজ বা স্তর অন্তর্ভুক্ত থাকে বা অ্যাড-অন সমর্থন থাকে তবে এটি প্রয়োজন। যদি আপনার সদস্যতা এক-স্তরযুক্ত হয় এবং আপনার ক্যাটালগের সমস্ত সামগ্রীতে অ্যাক্সেস দেয় তবে এটি অন্তর্ভুক্ত করবেন না।

মিডিয়া সাবস্ক্রিপশন উদাহরণ

একটি মিডিয়া সাবস্ক্রিপশন অবজেক্টের উদাহরণ:

"requiresSubscription": {
  "@type": "MediaSubscription",
  "@id": "http://www.example.com/premium_subscription",
  "name": "Example Premium",
  "sameAs": "http://www.example.com/premium_subscription"
}

অফার

একটি অফার বস্তু সামগ্রীর সাথে সম্পর্কিত মূল্য বর্ণনা করে। অবজেক্টটি নিম্নলিখিত অবজেক্টের একটি সম্পত্তি ( expectsAcceptanceOf ):

অফার উদাহরণ

ওয়াচ অ্যাকশন অ্যাকশন অ্যাক্সেস স্পেসিফিকেশন অবজেক্টে expectsAcceptanceOf সম্পত্তি নির্দিষ্ট করে:

"potentialAction":{
  "@type":"WatchAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2019-01-01T00:00Z",
    "availabilityEnds": "2019-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "My example seller"
      }
    }
  }
}

লিসেন অ্যাকশন অ্যাকশন মার্কআপ অবজেক্টে সরাসরি expectsAcceptanceOf প্রপার্টি নির্দিষ্ট করে:

"potentialAction":{
  "@type":"ListenAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "expectsAcceptanceOf":{
    "@type": "Offer",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    },
    "category": "subscription",
    "name": "Example Music",
    "price": 9.99,
    "priceCurrency": "USD",
    "seller": {
      "@type": "Organization",
      "name": "My example seller",
      "sameAs": "http://www.example.com"
    }
  }
}

ছবি

একটি ইমেজ অবজেক্ট কন্টেন্টের সাথে যুক্ত ইমেজ বর্ণনা করে।

ছবির জন্য প্রয়োজনীয়তা নিম্নরূপ:

  • ওয়াচ অ্যাকশনের জন্য, 2:3 আকৃতির অনুপাত সহ একটি উচ্চ-রেজোলিউশন চিত্র (সর্বনিম্ন 140x210 পিক্সেল) প্রদান করুন৷
    • ছবিটি .jpg বা .png ফরম্যাটে হতে হবে।
  • লিসেন অ্যাকশনের জন্য, 1x1 আকৃতির অনুপাত সহ একটি উচ্চ-রেজোলিউশন চিত্র (সর্বনিম্ন 300x300 পিক্সেল) প্রদান করুন।
    • আমরা 600x600 পিক্সেল বা উচ্চতর সুপারিশ করি।
    • ছবিটি .jpg , .png , বা .gif ফর্ম্যাটে হতে হবে৷
  • ছবির URL অবশ্যই ক্রলযোগ্য এবং সূচীযোগ্য হতে হবে।
  • আপনার অবশ্যই ছবিটি ব্যবহার করার অধিকার থাকতে হবে এবং ছবিটিকে Google ডিভাইস এবং বৈশিষ্ট্যে দেখানোর অনুমতি দিতে হবে।
  • ছবিতে নিম্নলিখিতগুলি থাকা উচিত নয়:
    • ঝাপসা, পিক্সেলযুক্ত, ঘোরানো বা খারাপ মানের ছবি।
    • লাইসেন্সবিহীন বা স্টক ফটোগ্রাফি।
    • নগ্নতা।
    • বেআইনি বিষয়বস্তু।
  • আপনি যখন MusicPlaylist আপডেট করেন, তখন নতুন বিষয়বস্তু প্রতিফলিত করতে এর ছবি আপডেট করুন।

ছবির উদাহরণ

"image": {
  "@type": "ImageObject",
  "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
  "dateModified" : "2019-01-05T22:11:33+00:00",
  "regionsAllowed" : ["US","UK","MX"]
}

ফিড উদাহরণ

নিম্নলিখিত উদাহরণগুলি ওয়াচ অ্যাকশন এবং লিসেন অ্যাকশনগুলির মধ্যে ফিড গঠনের পার্থক্য প্রদর্শন করে।

কর্ম উদাহরণ দেখুন

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

ক্রিয়া উদাহরণ শুনুন

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context":"http://schema.googleapis.com/",
      "@type":"MusicGroup",
      "@id":"http://www.example.com/artist/my_favorite_artist/",
      "url":"http://www.example.com/artist/my_favorite_artist/",
      "name":"My Favorite Artist",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_artist",
      "description":"This is my favorite pop music artist.",
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          },
          "price": 8.99,
          "priceCurrency": "USD"
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
        "url":"http://www.example.com/artist_mix/my_favorite_artist/",
        "name":"My Favorite Artist Mix",
        "description":"A mix of music similar to My Favorite Artist",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }
  ]
}