Archive: insert

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

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

  • फ़ाइल का ज़्यादा से ज़्यादा साइज़: मेल मैसेज का साइज़ 25 एमबी से ज़्यादा नहीं होना चाहिए. इस सीमा में मैसेज के मेटाडेटा हेडर, मुख्य हिस्से, और सभी अटैचमेंट शामिल हैं.
  • स्वीकार किए गए मीडिया MIME टाइप: 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 या डायरेक्ट्री एपीआई का इस्तेमाल करके ग्रुप का ईमेल पता बदलता है, तो आपको groupId वैरिएबल में नए ईमेल पते का इस्तेमाल करना होगा.
ज़रूरी क्वेरी पैरामीटर
uploadType string

/upload यूआरआई को अपलोड करने के लिए किए गए अनुरोध का टाइप, जिसकी वैल्यू यहां दी गई हैं:

  • media - मीडिया डेटा अपलोड करने वाला आसान अपलोड.
  • resumable - यह फिर से शुरू किया जा सकने वाला ऐसा अपलोड है जो कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करके, फिर से फिर से शुरू किया जा सकता है.

अनुमति देना

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

स्कोप
https://www.googleapis.com/auth/apps.groups.migration

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

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

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

जवाब

कामयाब होने पर, यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स का मुख्य हिस्सा दिखाता है:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा
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 एक साथ कई अनुरोधों के साथ काम नहीं करता. हालांकि, Groups Migration API अलग-अलग ग्रुप के संग्रह में ईमेल इंसर्शन के लिए एक साथ काम करने वाले अनुरोध काम करता है. एक 400 एचटीटीपी स्टेटस कोड मिलता है.