diff options
author | Debarshi Ray <debarshir@gnome.org> | 2016-06-17 12:53:24 +0200 |
---|---|---|
committer | Debarshi Ray <debarshir@gnome.org> | 2016-06-17 12:53:24 +0200 |
commit | f352682abd5897029f36435d1563ebc8fa7c1f43 (patch) | |
tree | 4dbe5d254582c15a80054faf23db473bee1be6dc | |
parent | a9183885cc58a19f5858bfe57c48aea0f5975ecc (diff) | |
download | libgdata-f352682abd5897029f36435d1563ebc8fa7c1f43.tar.gz |
picasaweb: Clarify how to handle authentication failures during upload
https://bugzilla.gnome.org/show_bug.cgi?id=767784
-rw-r--r-- | gdata/services/picasaweb/gdata-picasaweb-service.c | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c b/gdata/services/picasaweb/gdata-picasaweb-service.c index 67455a23..ee0ef4d1 100644 --- a/gdata/services/picasaweb/gdata-picasaweb-service.c +++ b/gdata/services/picasaweb/gdata-picasaweb-service.c @@ -586,8 +586,10 @@ gdata_picasaweb_service_query_files_async (GDataPicasaWebService *self, GDataPic * #GDataUploadStream. 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 %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. If no user is authenticated - * with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned. + * If @file has already been inserted, a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. + * + * If no user is authenticated with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned. It is recommended to retry the + * upload after refreshing the authorization tokens held by the associated #GDataAuthorizer using gdata_authorizer_refresh_authorization(). * * The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream * is closed (using g_output_stream_close()), gdata_picasaweb_service_finish_file_upload() should be called on it to parse and return the updated |