core: Add GDataBatchable.is_supported virtual method

This new API is intended to be used by GDataYouTubeService to allow it
to indicate which batch operations it supports (since this has changed
since v3 of the API — now batch operations are no longer supported).

1 files changed, 10 insertions, 0 deletions

diff --git a/gdata/gdata-batchable.h b/gdata/gdata-batchable.h
index f8867602..23651f43 100644
--- a/gdata/gdata-batchable.h
+++ b/gdata/gdata-batchable.h
@@ -46,6 +46,13 @@ typedef struct _GDataBatchable		GDataBatchable; /* dummy typedef */
 
 /**
  * GDataBatchableIface:
+ * @is_supported: Determines whether the given #GDataBatchOperationType is
+ *    supported by this #GDataBatchable; if not, operations using it will return
+ *    %GDATA_SERVICE_ERROR_WITH_BATCH_OPERATION. It is valid for a
+ *    #GDataBatchable to return %FALSE for all #GDataBatchOperationTypes if the
+ *    server no longer supports batch operations. If this method is not
+ *    implemented, it is assumed that all #GDataBatchOperationTypes are
+ *    supported. Since: UNRELEASED.
  *
  * All the fields in the #GDataBatchableIface structure are private and should never be accessed directly.
  *
@@ -54,6 +61,9 @@ typedef struct _GDataBatchable		GDataBatchable; /* dummy typedef */
 typedef struct {
 	/*< private >*/
 	GTypeInterface parent;
+
+	/*< public >*/
+	gboolean (*is_supported) (GDataBatchOperationType operation_type);
 } GDataBatchableIface;
 
 GType gdata_batchable_get_type (void) G_GNUC_CONST;