Feature/append email

README.md

@@ -33,6 +33,7 @@
 	- [Office365.user.list()](#office365userlist)
 * [Google class](#google)
 	- [cs.NetKit.Google.new()](#csnetkitgooglenew)
+	- [Google.mail.append()](#googlemailappend)
 	- [Google.mail.createLabel()](#googlemailcreatelabel)
 	- [Google.mail.delete()](#googlemaildelete)
 	- [Google.mail.deleteLabel()](#googlemaildeletelabel)
@@ -1294,6 +1295,50 @@ var $google : cs.NetKit.Google
 $oAuth2:=New OAuth2 provider($param)
 $google:=cs.NetKit.Google.new($oAuth2;New object("mailType"; "MIME"))
 ```
+### Google.mail.append()
+
+**Google.mail.append**( *mail* : Text { ; *labelIds* : Collection } ) : Object <br/>
+**Google.mail.append**( *mail* : Blob { ; *labelIds* : Collection } ) : Object <br/>
+**Google.mail.append**( *mail* : Object { ; *labelIds* : Collection } ) : Object <br/>
+
+#### Parameters 
+|Parameter|Type||Description|
+|---------|--- |:---:|------|
+|mail|Text &#124; Blob &#124; Object|->|Email to be append |
+|labelIds|Collection|->|Collection of label IDs to add to messages. By default the DRAFT label is applied|
+|Result|Object|<-|[Status object](#status-object-google-class)|
+
+
+#### Description
+
+`Google.mail.append()` appends *mail* to the user's mailbox as a DRAFT or with designated *labelIds*.
+
+>If the *labelIds* parameter is passed and the mail has a "from" or "sender" header, the Gmail server automatically adds the SENT label.
+
+#### Returned object 
+
+The method returns a [**status object**](status-object-google-class) with an additional "id" property:
+
+|Property|Type|Description|
+|---------|--- |------|
+|id|Text|id of the email created on the server|
+|success|Boolean| [see Status object](#status-object-google-class)|
+|statusText|Text| [see Status object](#status-object-google-class)|
+|errors|Collection| [see Status object](#status-object-google-class)|
+
+#### Example
+
+To append an email :
+
+```4d
+$status:=$google.mail.append($mail)
+```
+
+By default, the mail is created with a DRAFT label. To change the designated label, pass a second parameter:
+
+```4d
+$status:=$google.mail.append($mail;["INBOX"])
+```
 
 ### Google.mail.createLabel()