upload_file
Description:
public UploadStream upload_file (PicasaWebAlbum? album, PicasaWebFile file_entry, string slug, string content_type, Cancellable? cancellable = null) throws Error
Uploads a file (photo or video) to the given PicasaWeb album, using the metadata from file and the file data written
to the resulting UploadStream.
If album is null, the file will be uploaded to the currently-authenticated user's "Drop Box" album. A user must be
authenticated to use this function.
If file has already been inserted, a
ENTRY_ALREADYSERTED error will be returned.
If no user is authenticated with the service, AUTHENTICATION_REQUIRED will be returned. It is recommended to retry the upload after refreshing the authorization tokens held by the associated Authorizer using refresh_authorization.
The stream returned by this function should be written to using the standard
OutputStream methods, asynchronously or synchronously. Once the stream is closed (using
close),
finish_file_upload should be called on it to parse and
return the updated PicasaWebFile for the uploaded file. This must be done, as
file_entry isn't updated in-place.
In order to cancel the upload, a Cancellable passed in to cancellable
must be cancelled using cancel. Cancelling the individual
OutputStream operations on the
UploadStream will not cancel the entire upload; merely the write or close
operation in question. See the cancellable for more details.
Any upload errors will be thrown by the stream methods, and may come from the ServiceError domain.
Parameters:
| this | |
| album |
a PicasaWebAlbum into which to insert the file, or |
| file_entry |
a PicasaWebFile to insert |
| slug |
the filename to give to the uploaded file |
| content_type |
the content type of the uploaded data |
| cancellable |
a Cancellable for the entire upload stream, or |
Returns:
|
a UploadStream to write the file data to, or |