ईमेल माइग्रेट करना

Groups Migration API का इस्तेमाल करके, किसी ईमेल को Google Groups में माइग्रेट करने से पहले, यह काम करें:

  • किसी ईमेल मैसेज को ग्रुप के संग्रह में माइग्रेट करने से पहले, पक्का करें कि टारगेट ग्रुप मौजूद हो और उसका ईमेल पता सही हो. ग्रुप और उपयोगकर्ताओं की सूची के बारे में ज़्यादा जानने के लिए, Directory API देखें.
  • अगर ईमेल भेजने वाले का डोमेन, टारगेट ग्रुप के डोमेन जैसा है, तो ईमेल मैसेज को टारगेट ग्रुप के संग्रह में माइग्रेट करने से पहले, पक्का करें कि ईमेल भेजने वाला मौजूद हो.
  • ईमेल मैसेज का फ़ॉर्मैट, RFC 822 स्टैंडर्ड के मुताबिक होना चाहिए. Content-type: message/rfc822 हेडर का इस्तेमाल करें. पक्का करें कि ईमेल मैसेज के To:, From:, और Date: फ़ील्ड सही तरीके से फ़ॉर्मैट किए गए हों. जवाब, JSON डेटा फ़ॉर्मैट में मिलता है.

किसी ईमेल मैसेज को Google Groups में माइग्रेट करना

किसी ईमेल मैसेज को ग्रुप के संग्रह में माइग्रेट करने के लिए, POST एचटीटीपी अनुरोध भेजें, इसमें Authorization हेडर शामिल करें. साथ ही, GROUP_EMAIL_ADDRESS की जगह उस ग्रुप का ईमेल पता डालें जिसके लिए मैसेज भेजे जा रहे हैं:

POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media

अनुरोध का उदाहरण

इस उदाहरण में, ईमेल मैसेज को samplegroup@googlegroups.com के संग्रह में माइग्रेट किया गया है. Content-Length की सीमा 25 एमबी है. इसमें मैसेज का मेटाडेटा, मुख्य हिस्सा, और अटैचमेंट शामिल हैं:

POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer AUTH_TOKEN

METADATA_BODY

इनकी जगह ये डालें:

  • BYTES: ईमेल में मौजूद बाइट की संख्या.
  • AUTH_TOKEN: Authorization हेडर.
  • METADATA_BODY: ईमेल का मेटाडेटा, मुख्य हिस्सा, और अटैचमेंट.

यहां RFC 822 टेक्स्ट फ़ॉर्मैट में एक ईमेल मैसेज का उदाहरण दिया गया है, जिसे samplegroup@googlegroups.com के संग्रह में माइग्रेट किया गया है. इस उदाहरण में, NNNN@mail.samplegroup.com मैसेज-आईडी है. माइग्रेट किए गए ईमेल का भेजने वाला samplesender@example.com है. साथ ही, ईमेल को samplegroup@googlegroups.com ग्रुप के संग्रह में माइग्रेट किया गया है:

    Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)
    Message-ID: <NNNN@mail.samplegroup.com>
    Date: Mon, 16 Jul 2007 10:12:26 -0700
    From: samplesender@example.com
    To: samplegroup@googlegroups.com
    Subject: SUBJECT
    MIME-Version: 1.0
    Content-Type: text/plain; charset=ISO-8859-1; format=flowed
    Content-Transfer-Encoding: 7bit
    Content-Disposition: inline
    Delivered-To: samplegroup@samplegroup.com

    This is the body of the migrated email message.

अनुरोध पूरा होने पर, 200 एचटीटीपी स्टेटस कोड और माइग्रेशन की स्थिति मिलती है. responseCode की वैल्यू के बारे में ज़्यादा जानने के लिए, Groups Migration API का रेफ़रंस देखें.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

Google Groups के इंटरफ़ेस पर इंपोर्ट किए गए मैसेज देखना

Google Groups पर, थ्रेड की पढ़ी गई या न पढ़ी गई स्थिति, हर उपयोगकर्ता के लिए अलग-अलग सेव की जाती है. Groups Migration API का इस्तेमाल करके, मैसेज और थ्रेड डालने पर, उन्हें ऐसे माना जाता है जैसे वे From: हेडर में मौजूद उपयोगकर्ता ने भेजे हों. इसका मतलब है कि From: हेडर में मौजूद उपयोगकर्ता को छोड़कर, बाकी सभी उपयोगकर्ताओं के लिए वे मैसेज, न पढ़े गए के तौर पर दिखते हैं. उदाहरण के लिए, JSON के पिछले अनुरोध के उदाहरण के बाद, SUBJECT टाइटल वाला मैसेज, samplesender@example.com के Google Groups में लॉग इन करने पर, पढ़े गए के तौर पर दिखता है. हालांकि, बाकी सभी उपयोगकर्ताओं के लिए वह मैसेज, नहीं पढ़े गए के तौर पर दिखता है.