Timeline

এই সম্পদের জন্য পদ্ধতির তালিকার জন্য, এই পৃষ্ঠার শেষে দেখুন।

সম্পদ উপস্থাপনা

ব্যবহারকারীর টাইমলাইনে প্রতিটি আইটেম একটি TimelineItem JSON কাঠামো হিসাবে উপস্থাপন করা হয়, নীচে বর্ণিত। 

{
  "kind": "mirror#timelineItem",
  "id": string,
  "sourceItemId": string,
  "canonicalUrl": string,
  "bundleId": string,
  "isBundleCover": boolean,
  "selfLink": string,
  "created": datetime,
  "updated": datetime,
  "displayTime": datetime,
  "isPinned": boolean,
  "pinScore": integer,
  "isDeleted": boolean,
  "etag": etag,
  "creator": contacts Resource,
  "recipients": [
    contacts Resource
  ],
  "inReplyTo": string,
  "title": string,
  "text": string,
  "html": string,
  "speakableType": string,
  "speakableText": string,
  "attachments": [
    timeline.attachments Resource
  ],
  "location": locations Resource,
  "menuItems": [
    {
      "id": string,
      "action": string,
      "values": [
        {
          "state": string,
          "displayName": string,
          "iconUrl": string
        }
      ],
      "removeWhenSelected": boolean,
      "payload": string
    }
  ],
  "notification": {
    "level": string,
    "deliveryTime": datetime
  }
}
সম্পত্তির নাম মান বর্ণনা নোট
attachments[] list এই আইটেমটির সাথে যুক্ত মিডিয়া সংযুক্তির একটি তালিকা৷ একটি সুবিধা হিসাবে, আপনি সংযুক্তি বা cid স্কিমের সাথে আপনার HTML পেলোডগুলিতে সংযুক্তিগুলি উল্লেখ করতে পারেন৷ যেমন:
  • সংযুক্তি: <img src="attachment:attachment_index"> যেখানে সংযুক্তি_সূচী হল এই অ্যারের 0-ভিত্তিক সূচক৷
  • cid: <img src="cid:attachment_id"> যেখানে attachment_id হল সংযুক্তির ID ।
bundleId string এই আইটেমের জন্য বান্ডেল আইডি। অনেক আইটেম একসাথে গ্রুপ করার জন্য পরিষেবাগুলি একটি bundleId নির্দিষ্ট করতে পারে। তারা ডিভাইসে একটি একক শীর্ষ-স্তরের আইটেমের অধীনে প্রদর্শিত হয়। লিখনযোগ্য
canonicalUrl string টাইমলাইন আইটেম দ্বারা উপস্থাপিত ডেটার ক্যানোনিকাল/উচ্চ মানের সংস্করণের দিকে নির্দেশ করে একটি আদর্শ URL। লিখনযোগ্য
created datetime যে সময়ে এই আইটেমটি তৈরি করা হয়েছিল, RFC 3339 অনুযায়ী ফর্ম্যাট করা হয়েছে৷
creator nested object এই আইটেমটি তৈরি করা ব্যবহারকারী বা গোষ্ঠী৷ লিখনযোগ্য
displayTime datetime যখন এই আইটেমটি টাইমলাইনে দেখা হবে তখন যে সময়টি প্রদর্শিত হবে, RFC 3339 অনুযায়ী ফর্ম্যাট করা হয়েছে৷ এই ব্যবহারকারীর টাইমলাইনটি প্রদর্শনের সময় কালানুক্রমিকভাবে সাজানো হয়েছে, তাই এটি টাইমলাইনে আইটেমটি কোথায় প্রদর্শিত হবে তাও নির্ধারণ করবে৷ পরিষেবা দ্বারা সেট না করা থাকলে, ডিসপ্লে সময় updated সময়ে ডিফল্ট হয়। লিখনযোগ্য
etag etag এই আইটেম জন্য ETag.
html string এই আইটেমটির জন্য HTML সামগ্রী। যদি কোনো আইটেমের জন্য text এবং html উভয়ই দেওয়া থাকে, তাহলে html টাইমলাইনে রেন্ডার করা হবে।

অনুমোদিত HTML উপাদান - আপনি আপনার টাইমলাইন কার্ডগুলিতে এই উপাদানগুলি ব্যবহার করতে পারেন৷

  • হেডার: h1, h2, h3, h4, h5, h6
  • ছবি: img
  • তালিকা: li, ol, ul
  • HTML5 শব্দার্থবিদ্যা: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time
  • স্ট্রাকচারাল: blockquote, br, div, hr, p, span
  • শৈলী: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup
  • টেবিল: table, tbody, td, tfoot, th, thead, tr

অবরুদ্ধ এইচটিএমএল উপাদান : এই উপাদান এবং তাদের বিষয়বস্তু HTML পেলোড থেকে সরানো হয়।

  • ডকুমেন্ট হেডার: head, title
  • এম্বেড: audio, embed, object, source, video
  • ফ্রেম: frame, frameset
  • স্ক্রিপ্টিং: applet, script

অন্যান্য উপাদান : তালিকাভুক্ত নয় এমন কোনো উপাদান সরানো হয়, তবে তাদের বিষয়বস্তু সংরক্ষিত থাকে।

 লিখনযোগ্য
id string টাইমলাইন আইটেমের আইডি। এটি একজন ব্যবহারকারীর টাইমলাইনের মধ্যে অনন্য।
inReplyTo string যদি এই আইটেমটি অন্য আইটেমের উত্তর হিসাবে তৈরি করা হয়, তাহলে এই ক্ষেত্রটি যে আইটেমের উত্তর দেওয়া হচ্ছে তার আইডিতে সেট করা হবে। এটি উপযুক্ত কথোপকথন বা পোস্টে একটি উত্তর সংযুক্ত করতে ব্যবহার করা যেতে পারে।
isBundleCover boolean এই আইটেমটি একটি বান্ডিল কভার কিনা.

যদি একটি আইটেম একটি বান্ডেল কভার হিসাবে চিহ্নিত করা হয়, এটি সেই আইটেমটির মতো একই bundleId আইটেমগুলির বান্ডিলের প্রবেশ বিন্দু হবে৷ এটি শুধুমাত্র প্রধান টাইমলাইনে দেখানো হবে — খোলা বান্ডেলের মধ্যে নয় ।

প্রধান টাইমলাইনে, যে আইটেমগুলি দেখানো হয়েছে তা হল:
  • isBundleCover আছে যে আইটেম true সেট
  • আইটেম যে একটি bundleId নেই
একটি বান্ডেল সাব-টাইমলাইনে, যে আইটেমগুলি দেখানো হয়েছে তা হল:
  • যে আইটেমগুলির bundleId প্রশ্নে আছে এবং isBundleCover false সেট করা হয়েছে৷
 লিখনযোগ্য
isDeleted boolean সত্য হলে, নির্দেশ করে এই আইটেমটি মুছে ফেলা হয়েছে, এবং শুধুমাত্র আইডি বৈশিষ্ট্য সেট করা হয়েছে।
isPinned boolean সত্য হলে, নির্দেশ করে যে এই আইটেমটি পিন করা হয়েছে, যার মানে এটি ঐতিহাসিক (নন-পিন করা) টাইমলাইন আইটেমগুলি থেকে হোম স্ক্রিনের বিপরীত দিকে নেভিগেশন এবং হ্যাঙ্গআউটের মতো "সক্রিয়" আইটেমগুলির পাশাপাশি গোষ্ঠীবদ্ধ। আপনি ব্যবহারকারীকে TOGGLE_PINNED বিল্ট-ইন মেনু আইটেম দিয়ে এই সম্পত্তির মান টগল করার অনুমতি দিতে পারেন।
kind string সম্পদের ধরন। এটি সর্বদা mirror#timelineItem ।
location nested object এই আইটেমের সাথে যুক্ত ভৌগলিক অবস্থান। লিখনযোগ্য
notification nested object ডিভাইসে এই আইটেমের জন্য বিজ্ঞপ্তিগুলি কীভাবে উপস্থাপন করা হয় তা নিয়ন্ত্রণ করে। এটি অনুপস্থিত থাকলে, কোন বিজ্ঞপ্তি উত্পন্ন হবে না। লিখনযোগ্য
notification. deliveryTime datetime বিজ্ঞপ্তি যে সময়ে বিতরণ করা উচিত। লিখনযোগ্য
notification. level string বিজ্ঞপ্তিটি কতটা গুরুত্বপূর্ণ তা বর্ণনা করে। অনুমোদিত মান হল:
  • DEFAULT - ডিফল্ট গুরুত্বের বিজ্ঞপ্তি। ব্যবহারকারীদের সতর্ক করার জন্য একটি বাজানো হবে।
 লিখনযোগ্য
pinScore integer পিন করা আইটেমগুলির জন্য, এটি নির্ধারণ করে যে আইটেমটি টাইমলাইনে প্রদর্শিত হবে, ঘড়ির কাছাকাছি উচ্চতর স্কোর দেখা যাবে। দ্রষ্টব্য: এই ক্ষেত্রটি সেট করা বর্তমানে সমর্থিত নয়৷
recipients[] list এই আইটেমটি শেয়ার করা হয়েছে এমন ব্যবহারকারী বা গোষ্ঠীগুলির একটি তালিকা৷ লিখনযোগ্য
sourceItemId string অস্বচ্ছ স্ট্রিং আপনি আপনার নিজের পরিষেবাতে ডেটাতে একটি টাইমলাইন আইটেম ম্যাপ করতে ব্যবহার করতে পারেন। লিখনযোগ্য
speakableText string এই আইটেমটির বিষয়বস্তুর কথ্য সংস্করণ। READ_ALOUD মেনু আইটেমের সাথে, এই ক্ষেত্রটি ব্যবহার করুন পাঠ্য প্রদানের জন্য যা উচ্চস্বরে পড়ার সময় স্পষ্ট হবে, অথবা গ্লাসে যা দৃশ্যমানভাবে প্রদর্শিত হবে তার জন্য বর্ধিত তথ্য প্রদান করতে।

গ্লাসওয়্যারের স্পিকেবল টাইপ ক্ষেত্রটিও নির্দিষ্ট করা উচিত, যা এই পাঠ্যের আগে উচ্চারিত হবে এমন ক্ষেত্রে যেখানে অতিরিক্ত প্রসঙ্গ উপযোগী, উদাহরণস্বরূপ যখন ব্যবহারকারী অনুরোধ করে যে আইটেমটি একটি বিজ্ঞপ্তির পরে উচ্চস্বরে পড়ার জন্য।
 লিখনযোগ্য
speakableType string এই আইটেমটির প্রকারের একটি কথ্য বর্ণনা। আইটেমটির বিষয়বস্তু পড়ার আগে ব্যবহারকারীর কাছে এটি ঘোষণা করা হবে যেখানে অতিরিক্ত প্রসঙ্গটি দরকারী, উদাহরণস্বরূপ যখন ব্যবহারকারী অনুরোধ করে যে আইটেমটি একটি বিজ্ঞপ্তির পরে উচ্চস্বরে পড়ার জন্য।

এটি একটি সংক্ষিপ্ত, সাধারণ বিশেষ্য বাক্যাংশ যেমন "ইমেল", "টেক্সট বার্তা" বা "ডেইলি প্ল্যানেট নিউজ আপডেট" হওয়া উচিত।

গ্লাসওয়্যারকে প্রতিটি টাইমলাইন আইটেমের জন্য এই ক্ষেত্রটি পপুলেট করার জন্য উত্সাহিত করা হয়, এমনকি যদি আইটেমটিতে কথা বলার যোগ্য পাঠ্য বা পাঠ্য না থাকে যাতে ব্যবহারকারী পর্দার দিকে না তাকিয়ে আইটেমের ধরণটি শিখতে পারে।		 লিখনযোগ্য
text string এই আইটেমটির পাঠ্য বিষয়বস্তু। লিখনযোগ্য
title string এই আইটেম শিরোনাম. লিখনযোগ্য
updated datetime যে সময়ে এই আইটেমটি শেষবার সংশোধন করা হয়েছিল, RFC 3339 অনুযায়ী ফর্ম্যাট করা হয়েছে৷

পদ্ধতি

মুছে ফেলুন
একটি টাইমলাইন আইটেম মুছে দেয়।
পেতে
আইডি দ্বারা একটি একক টাইমলাইন আইটেম পায়.
সন্নিবেশ
টাইমলাইনে একটি নতুন আইটেম সন্নিবেশ করান।
তালিকা
প্রমাণীকৃত ব্যবহারকারীর জন্য টাইমলাইন আইটেমগুলির একটি তালিকা পুনরুদ্ধার করে।
প্যাচ
জায়গায় একটি টাইমলাইন আইটেম আপডেট করে। এই পদ্ধতি প্যাচ শব্দার্থবিদ্যা সমর্থন করে।
আপডেট
জায়গায় একটি টাইমলাইন আইটেম আপডেট করে।