REST Resource: users.messages

উৎস: বার্তা

একটি ইমেল বার্তা।

JSON উপস্থাপনা 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string,
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
ক্ষেত্র
id

string

বার্তাটির অপরিবর্তনীয় আইডি।

threadId

string

বার্তাটি যে থ্রেডের অন্তর্গত, তার আইডি। কোনো থ্রেডে বার্তা বা খসড়া যোগ করতে হলে, নিম্নলিখিত শর্তগুলো অবশ্যই পূরণ করতে হবে:

  1. আপনার অনুরোধের সাথে সরবরাহ করা Message বা Draft.Message এ অনুরোধকৃত threadId অবশ্যই উল্লেখ করতে হবে।
  2. References এবং In-Reply-To হেডার অবশ্যই RFC 2822 স্ট্যান্ডার্ড মেনে সেট করতে হবে।
  3. Subject শিরোনামগুলো অবশ্যই মিলতে হবে।

labelIds[]

string

এই বার্তায় প্রয়োগ করা লেবেলগুলির আইডি-র তালিকা।

snippet

string

বার্তার পাঠ্যের একটি সংক্ষিপ্ত অংশ।

historyId

string

সর্বশেষ যে হিস্ট্রি রেকর্ডটি এই বার্তাটি পরিবর্তন করেছে, তার আইডি।

internalDate

string ( int64 format)

অভ্যন্তরীণ বার্তা তৈরির টাইমস্ট্যাম্প (ইপক এমএস), যা ইনবক্সে বার্তার ক্রম নির্ধারণ করে। সাধারণ SMTP-এর মাধ্যমে প্রাপ্ত ইমেলের ক্ষেত্রে, এটি সেই সময়কে বোঝায় যখন বার্তাটি প্রথম গুগল দ্বারা গৃহীত হয়েছিল, যা Date হেডারের চেয়ে বেশি নির্ভরযোগ্য। তবে, এপিআই-এর মাধ্যমে স্থানান্তরিত মেইলের জন্য, ক্লায়েন্ট এটিকে Date হেডারের উপর ভিত্তি করে কনফিগার করতে পারে।

payload

object ( MessagePart )

বার্তার অংশগুলিতে পার্স করা ইমেলের কাঠামো।

sizeEstimate

integer

বার্তাটির আনুমানিক আকার (বাইটে)।

raw

string ( bytes format)

সম্পূর্ণ ইমেল বার্তাটি একটি RFC 2822 ফরম্যাটে এবং base64url এনকোডেড স্ট্রিং হিসেবে থাকে। format=RAW প্যারামিটারটি সরবরাহ করা হলে messages.get এবং drafts.get রেসপন্সে এটি ফেরত আসে।

একটি বেস৬৪-এনকোডেড স্ট্রিং।

classificationLabelValues[]

object ( ClassificationLabelValue )

মেসেজে ক্লাসিফিকেশন লেবেল ভ্যালু থাকে। গুগল ড্রাইভ লেবেল এপিআই (Google Drive Labels API) ব্যবহার করে উপলব্ধ ক্লাসিফিকেশন লেবেল স্কিমাগুলো কোয়েরি করা যায়। প্রতিটি ক্লাসিফিকেশন লেবেল আইডি অবশ্যই অনন্য হতে হবে। যদি একাধিক আইডি দেওয়া হয়, তবে শুধুমাত্র একটি রাখা হবে এবং এই নির্বাচনটি হবে যথেচ্ছ। এটি শুধুমাত্র গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য ব্যবহৃত হয়। প্রতি অনুরোধে ২০টি ক্লাসিফিকেশন লেবেল ভ্যালুর একটি সীমা রয়েছে। যদি ক্লাসিফিকেশন লেবেল ভ্যালুর সংখ্যা সর্বোচ্চ অনুমোদিত সংখ্যা অতিক্রম করে, তাহলে অনুরোধটি ব্যর্থ হবে।

বার্তা অংশ

একটি একক MIME বার্তার অংশ।

JSON উপস্থাপনা 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
ক্ষেত্র
partId

string

বার্তা অংশের অপরিবর্তনীয় আইডি।

mimeType

string

মেসেজ পার্টটির MIME টাইপ।

filename

string

সংযুক্তিটির ফাইলের নাম। এটি কেবল তখনই উপস্থিত থাকবে, যখন বার্তার এই অংশটি একটি সংযুক্তি নির্দেশ করে।

headers[]

object ( Header )

এই মেসেজ পার্টের হেডারগুলোর তালিকা। টপ-লেভেল মেসেজ পার্টের জন্য, যা সম্পূর্ণ মেসেজ পেলোডকে প্রতিনিধিত্ব করে, এতে স্ট্যান্ডার্ড RFC 2822 ইমেল হেডার যেমন To , From , এবং Subject অন্তর্ভুক্ত থাকবে।

body

object ( MessagePartBody )

এই অংশের জন্য বার্তার মূল অংশ, যা কন্টেইনার MIME বার্তা অংশগুলোর ক্ষেত্রে খালি থাকতে পারে।

parts[]

object ( MessagePart )

এই পার্টের চাইল্ড MIME মেসেজ পার্টগুলো। এটি শুধুমাত্র কন্টেইনার MIME মেসেজ পার্টগুলোর ক্ষেত্রে প্রযোজ্য, যেমন multipart/* । নন-কন্টেইনার MIME মেসেজ পার্ট টাইপগুলোর জন্য, যেমন text/plain , এই ফিল্ডটি খালি থাকে। আরও তথ্যের জন্য, RFC 1521 দেখুন।

JSON উপস্থাপনা 
{
  "name": string,
  "value": string
}
ক্ষেত্র
name

string

: বিভাজকের আগে হেডারের নাম। উদাহরণস্বরূপ, To .

value

string

কোলন : বিভাজকের পরের হেডারের মান। উদাহরণস্বরূপ, someuser@example.com ।

শ্রেণীবিভাগ লেবেল মান

ইমেল বার্তায় ক্লাসিফিকেশন লেবেল প্রয়োগ করা হয়। ক্লাসিফিকেশন লেবেল জিমেইল ইনবক্স লেবেল থেকে ভিন্ন। শুধুমাত্র গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য ব্যবহৃত হয়। ক্লাসিফিকেশন লেবেল সম্পর্কে আরও জানুন ।

JSON উপস্থাপনা 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
ক্ষেত্র
labelId

string

আবশ্যক। প্রামাণিক বা মূল আলফানিউমেরিক শ্রেণিবিন্যাস লেবেল আইডি। এটি গুগল ড্রাইভ লেবেল রিসোর্সের আইডি ফিল্ডের সাথে ম্যাপ করা হয়।

fields[]

object ( ClassificationLabelFieldValue )

প্রদত্ত শ্রেণিবিন্যাস লেবেল আইডির জন্য ফিল্ডের মানসমূহ।

শ্রেণীবিভাগ লেবেল ফিল্ড মান

একটি শ্রেণিবিন্যাস লেবেলের জন্য ফিল্ডের মানসমূহ।

JSON উপস্থাপনা 
{
  "fieldId": string,
  "selection": string
}
ক্ষেত্র
fieldId

string

আবশ্যক। ক্লাসিফিকেশন লেবেল ভ্যালু-এর জন্য ফিল্ড আইডি। এটি গুগল ড্রাইভ Label.Field অবজেক্টের ID ফিল্ডের সাথে ম্যাপ করা হয়।

selection

string

নির্বাচন বিকল্পের জন্য নির্বাচন পছন্দের আইডি। এটি শুধুমাত্র তখনই সেট করা উচিত যখন Google Drive Label.Field অবজেক্টে ফিল্ডের ধরন SELECTION হয়। এটি Google Drive Label.Field.SelectionOptions রিসোর্সের id ফিল্ডের সাথে ম্যাপ করা হয়।

পদ্ধতি

batchDelete

 মেসেজ আইডি দিয়ে একাধিক মেসেজ মুছে ফেলে।

batchModify

 নির্দিষ্ট বার্তাগুলির লেবেল এবং শ্রেণিবিন্যাস লেবেলের মান পরিবর্তন করে।

delete

 নির্দিষ্ট বার্তাটি তাৎক্ষণিকভাবে এবং স্থায়ীভাবে মুছে দেয়।

get

 নির্দিষ্ট বার্তাটি পায়।

import

 SMTP-এর মাধ্যমে বার্তা গ্রহণের অনুরূপ সাধারণ ইমেল ডেলিভারি স্ক্যানিং এবং শ্রেণিবিন্যাস সহ, এটি শুধুমাত্র এই ব্যবহারকারীর মেইলবক্সে একটি বার্তা আমদানি করে।

insert

 IMAP APPEND মতোই, এটি বেশিরভাগ স্ক্যানিং ও শ্রেণিবিন্যাস এড়িয়ে সরাসরি শুধুমাত্র এই ব্যবহারকারীর মেইলবক্সে একটি বার্তা যুক্ত করে।

list

 ব্যবহারকারীর মেইলবক্সে থাকা বার্তাগুলো তালিকাভুক্ত করে।

modify

 নির্দিষ্ট বার্তাটির লেবেল এবং শ্রেণিবিন্যাস লেবেলের মান পরিবর্তন করে।

send

 To , Cc , এবং Bcc হেডারে থাকা প্রাপকদের কাছে নির্দিষ্ট বার্তাটি পাঠায়।

trash

 নির্দিষ্ট বার্তাটি ট্র্যাশে স্থানান্তর করে।

untrash

 ট্র্যাশ থেকে নির্দিষ্ট বার্তাটি মুছে ফেলে।