इस पेज का अनुवाद Cloud Translation API से किया गया है.

Archive: insert

मीडिया अपलोड की सुविधा का इस्तेमाल करके, किसी ईमेल मैसेज को Google ग्रुप के संग्रह में माइग्रेट करता है.

यह तरीका, /upload यूआरआई के साथ काम करता है और इन विशेषताओं के साथ अपलोड किए गए मीडिया स्वीकार करता है:

फ़ाइल का ज़्यादा से ज़्यादा साइज़: ईमेल का साइज़ 25 एमबी से ज़्यादा नहीं होना चाहिए. इस सीमा में मैसेज का मेटाडेटा हेडर, मुख्य हिस्सा, और अटैचमेंट शामिल हैं.
स्वीकार किए जाने वाले मीडिया एमआईएमई टाइप: message/rfc822

Groups Migration API के लिए, प्रोजेक्ट की सीमा हर खाते के लिए 10 क्वेरी प्रति सेकंड (क्यूपीएस) है. हर दिन ज़्यादा से ज़्यादा 5,00,000 अनुरोध किए जा सकते हैं. RFC822 फ़ॉर्मैट के बारे में ज़्यादा जानकारी के लिए, RFC822 स्टैंडर्ड फ़ॉर्मैट देखें.

अनुरोध

एचटीटीपी अनुरोध

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

पैरामीटर

पैरामीटर का नाम	मान	ब्यौरा
पाथ पैरामीटर
`groupId`	`string`	उस ग्रुप का ईमेल पता जहां माइग्रेट किए गए ईमेल को संग्रहित किया गया है. यह ईमेल पता, अनुरोध के यूआरएल पाथ में एक वैरिएबल है. अगर ग्रुप का मालिक, Admin console या Directory API का इस्तेमाल करके ग्रुप का ईमेल पता बदलता है, तो आपको `groupId` वैरिएबल में नए ईमेल पते का इस्तेमाल करना होगा.
ज़रूरी क्वेरी पैरामीटर
`uploadType`	`string`	`/upload` यूआरआई पर अपलोड करने के अनुरोध का टाइप, जिसमें इनमें से कोई एक वैल्यू हो: `media` - आसानी से अपलोड किया जा सकता है, जो मीडिया डेटा को अपलोड करता है. `resumable` - फिर से अपलोड किया जा सकने वाला तरीका, जो कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करके, फ़ाइल को फिर से अपलोड करता है.

अनुमति देना

इस अनुरोध के लिए, नीचे दिए गए स्कोप वाले अनुमति की ज़रूरत है:

दायरा
`https://www.googleapis.com/auth/apps.groups.migration`

ज़्यादा जानकारी के लिए, पुष्टि और अनुमति पेज देखें.

अनुरोध का मुख्य भाग

इस तरीके के साथ अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर एपीआई सही से जुड़ जाता है, तो यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स बॉडी दिखाता है:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}

प्रॉपर्टी का नाम मान ब्यौरा

kind string यह किस तरह का इंसर्ट रिसॉर्स है. वैल्यू: groupsmigration#groups

प्रॉपर्टी का नाम	मान	ब्यौरा
`kind`	`string`	यह किस तरह का इंसर्ट रिसॉर्स है. वैल्यू: `groupsmigration#groups`
`responseCode`	`string`	माइग्रेशन के अनुरोध के लिए, एपीआई के रिस्पॉन्स का स्टेटस कोड के साथ एचटीटीपी स्टेटस कोड. `responseCode` स्टेटस की वैल्यू में ये शामिल हैं: `AUTHORIZATION FAILURE` — एडमिन के अनुमति क्रेडेंशियल अमान्य हैं. एक `401` एचटीटीपी स्टेटस कोड मिला. `BACKEND FAILURE` — सर्वर में कोई समस्या है या सर्वर व्यस्त है. एक `503` एचटीटीपी स्टेटस कोड दिखाया गया. एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करके, असफल कॉल को फिर से आज़माने से पहले थोड़ी देर इंतज़ार करें. `INVALID MESSAGE FAILURE` — ईमेल मैसेज का फ़ॉर्मैट अमान्य है. अगर किसी मैसेज को अमान्य के तौर पर अस्वीकार कर दिया जाता है, तो आपको `400 Bad Request` एचटीटीपी स्टेटस कोड मिलता है. अमान्य फ़ॉर्मैट के उदाहरणों में ये शामिल हैं: मैसेज में `From`, `To`, और `Date` फ़ील्ड मौजूद न हो सकते. मैसेज की किसी लाइन को सीआर+एलएफ़ (यानी, `"\r\n"`) स्टाइल न्यूलाइन से खत्म नहीं किया जाता है. ऐसे में, गड़बड़ी का मैसेज मिलता है. ईमेल मैसेज खाली है. माइग्रेशन का टारगेट ग्रुप मौजूद नहीं है या 'रीड-ओनली' मोड में है. सिर्फ़ पढ़ने के लिए उपलब्ध शेयर करने के मोड के बारे में ज़्यादा जानकारी के लिए, Google Groups for Business के शेयर करने के विकल्प देखें. `SUCCESS` — ईमेल को खाते के ग्रुप संग्रह में संग्रहित कर लिया गया है. `200` एचटीटीपी स्टेटस कोड दिखाया जाता है. `UNSUPPORTED_PARALLEL_OPERATION` — Groups Migration API, एक ही ग्रुप संग्रह में साथ-साथ मैसेज शामिल करने की सुविधा नहीं देता. इसके अलावा, Groups Migration API पर एक साथ कई अनुरोध करने की सुविधा भी उपलब्ध नहीं है. हालांकि, ग्रुप माइग्रेशन एपीआई, अलग-अलग ग्रुप संग्रह में ईमेल डालने के लिए, एक साथ कई अनुरोधों को प्रोसेस कर सकता है. `400` एचटीटीपी स्टेटस कोड दिखाया जाता है.

responseCode

string

माइग्रेशन के अनुरोध के लिए, एपीआई के रिस्पॉन्स का स्टेटस कोड के साथ एचटीटीपी स्टेटस कोड. responseCode स्टेटस की वैल्यू में ये शामिल हैं:

AUTHORIZATION FAILURE — एडमिन के अनुमति क्रेडेंशियल अमान्य हैं. एक 401 एचटीटीपी स्टेटस कोड मिला.

BACKEND FAILURE — सर्वर में कोई समस्या है या सर्वर व्यस्त है. एक 503 एचटीटीपी स्टेटस कोड दिखाया गया. एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करके, असफल कॉल को फिर से आज़माने से पहले थोड़ी देर इंतज़ार करें.

INVALID MESSAGE FAILURE — ईमेल मैसेज का फ़ॉर्मैट अमान्य है. अगर किसी मैसेज को अमान्य के तौर पर अस्वीकार कर दिया जाता है, तो आपको 400 Bad Request एचटीटीपी स्टेटस कोड मिलता है. अमान्य फ़ॉर्मैट के उदाहरणों में ये शामिल हैं:

मैसेज में From, To, और Date फ़ील्ड मौजूद न हो सकते.
मैसेज की किसी लाइन को सीआर+एलएफ़ (यानी, "\r\n") स्टाइल न्यूलाइन से खत्म नहीं किया जाता है. ऐसे में, गड़बड़ी का मैसेज मिलता है.
ईमेल मैसेज खाली है.
माइग्रेशन का टारगेट ग्रुप मौजूद नहीं है या 'रीड-ओनली' मोड में है. सिर्फ़ पढ़ने के लिए उपलब्ध शेयर करने के मोड के बारे में ज़्यादा जानकारी के लिए, Google Groups for Business के शेयर करने के विकल्प देखें.

SUCCESS — ईमेल को खाते के ग्रुप संग्रह में संग्रहित कर लिया गया है. 200 एचटीटीपी स्टेटस कोड दिखाया जाता है.

UNSUPPORTED_PARALLEL_OPERATION — Groups Migration API, एक ही ग्रुप संग्रह में साथ-साथ मैसेज शामिल करने की सुविधा नहीं देता. इसके अलावा, Groups Migration API पर एक साथ कई अनुरोध करने की सुविधा भी उपलब्ध नहीं है. हालांकि, ग्रुप माइग्रेशन एपीआई, अलग-अलग ग्रुप संग्रह में ईमेल डालने के लिए, एक साथ कई अनुरोधों को प्रोसेस कर सकता है. 400 एचटीटीपी स्टेटस कोड दिखाया जाता है.