| // Package admin provides access to the Email Migration API v2. |
| // |
| // See https://developers.google.com/admin-sdk/email-migration/v2/ |
| // |
| // Usage example: |
| // |
| // import "google.golang.org/api/admin/email_migration/v2" |
| // ... |
| // adminService, err := admin.New(oauthHttpClient) |
| package admin // import "google.golang.org/api/admin/email_migration/v2" |
| |
| import ( |
| "bytes" |
| "encoding/json" |
| "errors" |
| "fmt" |
| context "golang.org/x/net/context" |
| ctxhttp "golang.org/x/net/context/ctxhttp" |
| gensupport "google.golang.org/api/gensupport" |
| googleapi "google.golang.org/api/googleapi" |
| "io" |
| "net/http" |
| "net/url" |
| "strconv" |
| "strings" |
| ) |
| |
| // Always reference these packages, just in case the auto-generated code |
| // below doesn't. |
| var _ = bytes.NewBuffer |
| var _ = strconv.Itoa |
| var _ = fmt.Sprintf |
| var _ = json.NewDecoder |
| var _ = io.Copy |
| var _ = url.Parse |
| var _ = gensupport.MarshalJSON |
| var _ = googleapi.Version |
| var _ = errors.New |
| var _ = strings.Replace |
| var _ = context.Canceled |
| var _ = ctxhttp.Do |
| |
| const apiId = "admin:email_migration_v2" |
| const apiName = "admin" |
| const apiVersion = "email_migration_v2" |
| const basePath = "https://www.googleapis.com/email/v2/users/" |
| |
| // OAuth2 scopes used by this API. |
| const ( |
| // Manage email messages of users on your domain |
| EmailMigrationScope = "https://www.googleapis.com/auth/email.migration" |
| ) |
| |
| func New(client *http.Client) (*Service, error) { |
| if client == nil { |
| return nil, errors.New("client is nil") |
| } |
| s := &Service{client: client, BasePath: basePath} |
| s.Mail = NewMailService(s) |
| return s, nil |
| } |
| |
| type Service struct { |
| client *http.Client |
| BasePath string // API endpoint base URL |
| UserAgent string // optional additional User-Agent fragment |
| |
| Mail *MailService |
| } |
| |
| func (s *Service) userAgent() string { |
| if s.UserAgent == "" { |
| return googleapi.UserAgent |
| } |
| return googleapi.UserAgent + " " + s.UserAgent |
| } |
| |
| func NewMailService(s *Service) *MailService { |
| rs := &MailService{s: s} |
| return rs |
| } |
| |
| type MailService struct { |
| s *Service |
| } |
| |
| // MailItem: JSON template for MailItem object in Email Migration API. |
| type MailItem struct { |
| // IsDeleted: Boolean indicating if the mail is deleted (used in Vault) |
| IsDeleted bool `json:"isDeleted,omitempty"` |
| |
| // IsDraft: Boolean indicating if the mail is draft |
| IsDraft bool `json:"isDraft,omitempty"` |
| |
| // IsInbox: Boolean indicating if the mail is in inbox |
| IsInbox bool `json:"isInbox,omitempty"` |
| |
| // IsSent: Boolean indicating if the mail is in 'sent mails' |
| IsSent bool `json:"isSent,omitempty"` |
| |
| // IsStarred: Boolean indicating if the mail is starred |
| IsStarred bool `json:"isStarred,omitempty"` |
| |
| // IsTrash: Boolean indicating if the mail is in trash |
| IsTrash bool `json:"isTrash,omitempty"` |
| |
| // IsUnread: Boolean indicating if the mail is unread |
| IsUnread bool `json:"isUnread,omitempty"` |
| |
| // Kind: Kind of resource this is. |
| Kind string `json:"kind,omitempty"` |
| |
| // Labels: List of labels (strings) |
| Labels []string `json:"labels,omitempty"` |
| |
| // ForceSendFields is a list of field names (e.g. "IsDeleted") to |
| // unconditionally include in API requests. By default, fields with |
| // empty values are omitted from API requests. However, any non-pointer, |
| // non-interface field appearing in ForceSendFields will be sent to the |
| // server regardless of whether the field is empty or not. This may be |
| // used to include empty fields in Patch requests. |
| ForceSendFields []string `json:"-"` |
| } |
| |
| func (s *MailItem) MarshalJSON() ([]byte, error) { |
| type noMethod MailItem |
| raw := noMethod(*s) |
| return gensupport.MarshalJSON(raw, s.ForceSendFields) |
| } |
| |
| // method id "emailMigration.mail.insert": |
| |
| type MailInsertCall struct { |
| s *Service |
| userKey string |
| mailitem *MailItem |
| urlParams_ gensupport.URLParams |
| media_ io.Reader |
| resumableBuffer_ *gensupport.ResumableBuffer |
| mediaType_ string |
| mediaSize_ int64 // mediaSize, if known. Used only for calls to progressUpdater_. |
| progressUpdater_ googleapi.ProgressUpdater |
| ctx_ context.Context |
| } |
| |
| // Insert: Insert Mail into Google's Gmail backends |
| func (r *MailService) Insert(userKey string, mailitem *MailItem) *MailInsertCall { |
| c := &MailInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} |
| c.userKey = userKey |
| c.mailitem = mailitem |
| return c |
| } |
| |
| // Media specifies the media to upload in one or more chunks. The chunk |
| // size may be controlled by supplying a MediaOption generated by |
| // googleapi.ChunkSize. The chunk size defaults to |
| // googleapi.DefaultUploadChunkSize.The Content-Type header used in the |
| // upload request will be determined by sniffing the contents of r, |
| // unless a MediaOption generated by googleapi.ContentType is |
| // supplied. |
| // At most one of Media and ResumableMedia may be set. |
| func (c *MailInsertCall) Media(r io.Reader, options ...googleapi.MediaOption) *MailInsertCall { |
| opts := googleapi.ProcessMediaOptions(options) |
| chunkSize := opts.ChunkSize |
| if !opts.ForceEmptyContentType { |
| r, c.mediaType_ = gensupport.DetermineContentType(r, opts.ContentType) |
| } |
| c.media_, c.resumableBuffer_ = gensupport.PrepareUpload(r, chunkSize) |
| return c |
| } |
| |
| // ResumableMedia specifies the media to upload in chunks and can be |
| // canceled with ctx. |
| // |
| // Deprecated: use Media instead. |
| // |
| // At most one of Media and ResumableMedia may be set. mediaType |
| // identifies the MIME media type of the upload, such as "image/png". If |
| // mediaType is "", it will be auto-detected. The provided ctx will |
| // supersede any context previously provided to the Context method. |
| func (c *MailInsertCall) ResumableMedia(ctx context.Context, r io.ReaderAt, size int64, mediaType string) *MailInsertCall { |
| c.ctx_ = ctx |
| rdr := gensupport.ReaderAtToReader(r, size) |
| rdr, c.mediaType_ = gensupport.DetermineContentType(rdr, mediaType) |
| c.resumableBuffer_ = gensupport.NewResumableBuffer(rdr, googleapi.DefaultUploadChunkSize) |
| c.media_ = nil |
| c.mediaSize_ = size |
| return c |
| } |
| |
| // ProgressUpdater provides a callback function that will be called |
| // after every chunk. It should be a low-latency function in order to |
| // not slow down the upload operation. This should only be called when |
| // using ResumableMedia (as opposed to Media). |
| func (c *MailInsertCall) ProgressUpdater(pu googleapi.ProgressUpdater) *MailInsertCall { |
| c.progressUpdater_ = pu |
| return c |
| } |
| |
| // Fields allows partial responses to be retrieved. See |
| // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse |
| // for more information. |
| func (c *MailInsertCall) Fields(s ...googleapi.Field) *MailInsertCall { |
| c.urlParams_.Set("fields", googleapi.CombineFields(s)) |
| return c |
| } |
| |
| // Context sets the context to be used in this call's Do method. Any |
| // pending HTTP request will be aborted if the provided context is |
| // canceled. |
| // This context will supersede any context previously provided to the |
| // ResumableMedia method. |
| func (c *MailInsertCall) Context(ctx context.Context) *MailInsertCall { |
| c.ctx_ = ctx |
| return c |
| } |
| |
| func (c *MailInsertCall) doRequest(alt string) (*http.Response, error) { |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.mailitem) |
| if err != nil { |
| return nil, err |
| } |
| ctype := "application/json" |
| c.urlParams_.Set("alt", alt) |
| urls := googleapi.ResolveRelative(c.s.BasePath, "{userKey}/mail") |
| if c.media_ != nil || c.resumableBuffer_ != nil { |
| urls = strings.Replace(urls, "https://www.googleapis.com/", "https://www.googleapis.com/upload/", 1) |
| protocol := "multipart" |
| if c.resumableBuffer_ != nil { |
| protocol = "resumable" |
| } |
| c.urlParams_.Set("uploadType", protocol) |
| } |
| urls += "?" + c.urlParams_.Encode() |
| if c.media_ != nil { |
| var combined io.ReadCloser |
| combined, ctype = gensupport.CombineBodyMedia(body, ctype, c.media_, c.mediaType_) |
| defer combined.Close() |
| body = combined |
| } |
| req, _ := http.NewRequest("POST", urls, body) |
| googleapi.Expand(req.URL, map[string]string{ |
| "userKey": c.userKey, |
| }) |
| if c.resumableBuffer_ != nil && c.mediaType_ != "" { |
| req.Header.Set("X-Upload-Content-Type", c.mediaType_) |
| } |
| req.Header.Set("Content-Type", ctype) |
| req.Header.Set("User-Agent", c.s.userAgent()) |
| if c.ctx_ != nil { |
| return ctxhttp.Do(c.ctx_, c.s.client, req) |
| } |
| return c.s.client.Do(req) |
| } |
| |
| // Do executes the "emailMigration.mail.insert" call. |
| func (c *MailInsertCall) Do(opts ...googleapi.CallOption) error { |
| gensupport.SetOptions(c.urlParams_, opts...) |
| res, err := gensupport.Retry(c.ctx_, func() (*http.Response, error) { |
| return c.doRequest("json") |
| }, gensupport.DefaultBackoffStrategy()) |
| if err != nil { |
| return err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return err |
| } |
| if c.resumableBuffer_ != nil { |
| loc := res.Header.Get("Location") |
| rx := &gensupport.ResumableUpload{ |
| Client: c.s.client, |
| UserAgent: c.s.userAgent(), |
| URI: loc, |
| Media: c.resumableBuffer_, |
| MediaType: c.mediaType_, |
| Callback: func(curr int64) { |
| if c.progressUpdater_ != nil { |
| c.progressUpdater_(curr, c.mediaSize_) |
| } |
| }, |
| } |
| ctx := c.ctx_ |
| if ctx == nil { |
| ctx = context.TODO() |
| } |
| res, err = rx.Upload(ctx) |
| if err != nil { |
| return err |
| } |
| defer res.Body.Close() |
| if err := googleapi.CheckResponse(res); err != nil { |
| return err |
| } |
| } |
| return nil |
| // { |
| // "description": "Insert Mail into Google's Gmail backends", |
| // "httpMethod": "POST", |
| // "id": "emailMigration.mail.insert", |
| // "mediaUpload": { |
| // "accept": [ |
| // "message/rfc822" |
| // ], |
| // "maxSize": "35MB", |
| // "protocols": { |
| // "resumable": { |
| // "multipart": true, |
| // "path": "/resumable/upload/email/v2/users/{userKey}/mail" |
| // }, |
| // "simple": { |
| // "multipart": true, |
| // "path": "/upload/email/v2/users/{userKey}/mail" |
| // } |
| // } |
| // }, |
| // "parameterOrder": [ |
| // "userKey" |
| // ], |
| // "parameters": { |
| // "userKey": { |
| // "description": "The email or immutable id of the user", |
| // "location": "path", |
| // "required": true, |
| // "type": "string" |
| // } |
| // }, |
| // "path": "{userKey}/mail", |
| // "request": { |
| // "$ref": "MailItem" |
| // }, |
| // "scopes": [ |
| // "https://www.googleapis.com/auth/email.migration" |
| // ], |
| // "supportsMediaUpload": true |
| // } |
| |
| } |