- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- HistoryType
- इतिहास
- MessageAdded
- MessageDeleted
- LabelAdded
- LabelRemoved
- इसे आज़माएं!
दिए गए मेलबॉक्स में सभी बदलावों का इतिहास सूची में शामिल करता है. इतिहास के नतीजे, समय के हिसाब से दिखाए जाते हैं (historyId
में बढ़ोतरी).
एचटीटीपी अनुरोध
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
userId |
उपयोगकर्ता का ईमेल पता. खास मान |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
maxResults |
दिए जाने वाले इतिहास के रिकॉर्ड की ज़्यादा से ज़्यादा संख्या. यह फ़ील्ड डिफ़ॉल्ट रूप से 100 पर सेट होता है. इस फ़ील्ड के लिए ज़्यादा से ज़्यादा 500 वैल्यू डाली जा सकती हैं. |
pageToken |
पेज टोकन का इस्तेमाल करके, सूची में मौजूद नतीजों का कोई खास पेज वापस पाया जा सकता है. |
startHistoryId |
ज़रूरी है. तय किए गए |
labelId |
सिर्फ़ आईडी से मेल खाने वाले लेबल वाले मैसेज दिखाएं. |
historyTypes[] |
फ़ंक्शन के ज़रिए दिखाए जाने वाले इतिहास के टाइप |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"history": [
{
object ( |
फ़ील्ड | |
---|---|
history[] |
इतिहास के रिकॉर्ड की सूची. जवाब में मौजूद किसी भी |
nextPageToken |
पेज टोकन का इस्तेमाल करके, सूची में नतीजों का अगला पेज वापस पाया जा सकता है. |
historyId |
मेलबॉक्स के वर्तमान इतिहास रिकॉर्ड का आईडी. |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.metadata
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
HistoryType
Enums | |
---|---|
messageAdded |
|
messageDeleted |
|
labelAdded |
|
labelRemoved |
इतिहास
उपयोगकर्ता के मेलबॉक्स में बदलाव का रिकॉर्ड. इतिहास में किए गए हर बदलाव की वजह से, आपके मैसेज पर कई तरह से असर पड़ सकता है.
JSON के काेड में दिखाना |
---|
{ "id": string, "messages": [ { object ( |
फ़ील्ड | |
---|---|
id |
मेलबॉक्स का क्रम आईडी. |
messages[] |
इतिहास के इस रिकॉर्ड में बदले गए मैसेज की सूची. खास तरह के बदलाव के लिए दिए गए फ़ील्ड, जैसे कि |
messagesAdded[] |
इतिहास के इस रिकॉर्ड में, मेलबॉक्स में जोड़े गए मैसेज. |
messagesDeleted[] |
इस इतिहास रिकॉर्ड में मौजूद मेलबॉक्स से मैसेज मिटाए गए (ट्रैश में नहीं डाले गए). |
labelsAdded[] |
इतिहास के इस रिकॉर्ड में मौजूद मैसेज में लेबल जोड़े गए. |
labelsRemoved[] |
इतिहास के इस रिकॉर्ड में मौजूद मैसेज से लेबल हटाए गए. |
MessageAdded
JSON के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
MessageDeleted
JSON के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
LabelAdded
JSON के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
labelIds[] |
मैसेज में लेबल आईडी जोड़े गए. |
LabelRemoved
JSON के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
labelIds[] |
मैसेज से लेबल आईडी हटाए गए. |