- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- 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[] |
फ़ंक्शन से दिखाए जाने वाले इतिहास के टाइप |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"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 |
इतिहास
उपयोगकर्ता के मेलबॉक्स में होने वाले बदलाव का रिकॉर्ड. इतिहास में किया गया हर बदलाव, एक से ज़्यादा मैसेज पर अलग-अलग तरह से असर डाल सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ "id": string, "messages": [ { object ( |
फ़ील्ड | |
---|---|
id |
मेलबॉक्स अनुक्रम आईडी. |
messages[] |
इतिहास के इस रिकॉर्ड में बदले गए मैसेज की सूची. खास तरह के बदलाव के लिए फ़ील्ड, जैसे कि |
messagesAdded[] |
इतिहास के इस रिकॉर्ड में, मेलबॉक्स में जोड़े गए मैसेज. |
messagesDeleted[] |
इतिहास रिकॉर्ड में मौजूद मेलबॉक्स से मिटाए गए (ट्रैश नहीं किए गए) मैसेज. |
labelsAdded[] |
इतिहास के इस रिकॉर्ड में मौजूद मैसेज में लेबल जोड़े गए. |
labelsRemoved[] |
इतिहास के इस रिकॉर्ड में मौजूद मैसेज से लेबल हटाए गए. |
MessageAdded
जेएसओएन के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
MessageDeleted
जेएसओएन के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
LabelAdded
जेएसओएन के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
labelIds[] |
मैसेज में लेबल आईडी जोड़े गए. |
LabelRemoved
जेएसओएन के काेड में दिखाना |
---|
{
"message": {
object ( |
फ़ील्ड | |
---|---|
message |
|
labelIds[] |
मैसेज से लेबल आईडी हटाए गए. |