summaryrefslogtreecommitdiff
path: root/gdata/services/documents/gdata-documents-drive-query.c
blob: e1914922702f4f8cf4dfe8e8844362a313893e0e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/*
 * GData Client
 * Copyright (C) Ondrej Holy 2020 <oholy@redhat.com>
 *
 * GData Client is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * GData Client is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with GData Client.  If not, see <http://www.gnu.org/licenses/>.
 */

/**
 * SECTION:gdata-documents-drive-query
 * @short_description: GData Documents Drive query object
 * @stability: Stable
 * @include: gdata/services/documents/gdata-documents-drive-query.h
 *
 * #GDataDocumentsDriveQuery represents a collection of query parameters specific to shared drives, which go above and beyond
 * those catered for by #GDataQuery.
 *
 * For more information on the custom GData query parameters supported by #GDataDocumentsDriveQuery, see the
 * [online documentation](https://developers.google.com/drive/api/v2/ref-search-terms#drive_properties).
 *
 * Since: 0.18.0
 */

#include <config.h>
#include <glib.h>
#include <glib/gi18n-lib.h>
#include <string.h>

#include "gdata-documents-drive-query.h"
#include "gdata-private.h"

static void get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboolean *params_started);

G_DEFINE_TYPE (GDataDocumentsDriveQuery, gdata_documents_drive_query, GDATA_TYPE_QUERY)

static void
gdata_documents_drive_query_class_init (GDataDocumentsDriveQueryClass *klass)
{
	GDataQueryClass *query_class = GDATA_QUERY_CLASS (klass);

	query_class->get_query_uri = get_query_uri;
}

static void
gdata_documents_drive_query_init (GDataDocumentsDriveQuery *self)
{
	/* https://developers.google.com/drive/api/v2/reference/drives/list#parameters */
	_gdata_query_set_pagination_type (GDATA_QUERY (self),
	                                  GDATA_QUERY_PAGINATION_TOKENS);
}

static void
get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboolean *params_started)
{
	guint max_results;

	#define APPEND_SEP g_string_append_c (query_uri, (*params_started == FALSE) ? '?' : '&'); *params_started = TRUE;

	_gdata_query_clear_q_internal (self);

	/* Chain up to the parent class */
	GDATA_QUERY_CLASS (gdata_documents_drive_query_parent_class)->get_query_uri (self, feed_uri, query_uri, params_started);

	/* https://developers.google.com/drive/api/v2/reference/drives/list */
	max_results = gdata_query_get_max_results (self);
	if (max_results > 0) {
		APPEND_SEP
		max_results = max_results > 100 ? 100 : max_results;
		g_string_append_printf (query_uri, "maxResults=%u", max_results);
	}
}

/**
 * gdata_documents_drive_query_new:
 * @q: (nullable): a query string, or %NULL
 *
 * Creates a new #GDataDocumentsDriveQuery with its #GDataQuery:q property set to @q.
 *
 * Return value: (transfer full): a new #GDataDocumentsDriveQuery
 *
 * Since: 0.18.0
 */
GDataDocumentsDriveQuery *
gdata_documents_drive_query_new (const gchar *q)
{
	return g_object_new (GDATA_TYPE_DOCUMENTS_DRIVE_QUERY, "q", q, NULL);
}