[ Version ( since = "0.9.0" ) ]
public Entry insert_entry (AuthorizationDomain? domain, string upload_uri, Entry entry, Cancellable? cancellable = null) throws Error
Inserts entry by uploading it to the online service at upload_uri.
For more information about the concept of inserting entries, see the online documentation for the GData protocol.
The service will return an updated version of the entry, which is the return value of this function on success.
If cancellable is not null, then the operation can be cancelled by triggering the cancellable
object from another thread. If the operation was cancelled before or during network activity, the error CANCELLED
will be returned. Cancellation has no effect after network activity has finished, however, and the insertion will return
successfully (or return an error sent by the server) if it is first cancelled after network activity has finished. See the overview of
cancellation for more details.
If the entry is marked as already having been inserted a ENTRY_ALREADYSERTED error will be returned immediately (there will be no network requests).
If there is an error inserting the entry, a PROTOCOL_ERROR error
will be returned. Currently, subclasses cannot cannot override this or provide more specific errors.
| this |
a Service |
| domain |
the AuthorizationDomain the insertion operation falls under, or |
| upload_uri |
the URI to which the upload should be sent |
| entry |
the Entry to insert |
| cancellable |
optional Cancellable object, or |
|
an updated Entry, or |