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 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143
use anyhow::Result;
use crate::Client;
pub struct Settings {
pub client: Client,
}
impl Settings {
#[doc(hidden)]
pub fn new(client: Client) -> Self {
Settings { client }
}
/**
* This function performs a `GET` to the `/users/me/settings` endpoint.
*
* Returns all user settings for the authenticated user.
*
* **Parameters:**
*
* * `max_results: i64` -- Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries. Optional.
* * `page_token: &str` -- Token specifying which result page to return. Optional.
* * `sync_token: &str` -- Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then.
* If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.
* Learn more about incremental synchronization.
* Optional. The default is to return all entries.
*/
pub async fn list(
&self,
max_results: i64,
page_token: &str,
) -> Result<Vec<crate::types::Setting>> {
let mut query_args: Vec<(String, String)> = Default::default();
if max_results > 0 {
query_args.push(("maxResults".to_string(), max_results.to_string()));
}
if !page_token.is_empty() {
query_args.push(("pageToken".to_string(), page_token.to_string()));
}
let query_ = serde_urlencoded::to_string(&query_args).unwrap();
let url = format!("/users/me/settings?{}", query_);
let resp: crate::types::Settings = self.client.get(&url, None).await?;
// Return our response data.
Ok(resp.items)
}
/**
* This function performs a `GET` to the `/users/me/settings` endpoint.
*
* As opposed to `list`, this function returns all the pages of the request at once.
*
* Returns all user settings for the authenticated user.
*/
pub async fn list_all(&self) -> Result<Vec<crate::types::Setting>> {
let url = "/users/me/settings".to_string();
let mut resp: crate::types::Settings = self.client.get(&url, None).await?;
let mut items = resp.items;
let mut page = resp.next_page_token;
// Paginate if we should.
while !page.is_empty() {
if !url.contains('?') {
resp = self
.client
.get(&format!("{}?pageToken={}", url, page), None)
.await?;
} else {
resp = self
.client
.get(&format!("{}&pageToken={}", url, page), None)
.await?;
}
items.append(&mut resp.items);
if !resp.next_page_token.is_empty() && resp.next_page_token != page {
page = resp.next_page_token.to_string();
} else {
page = "".to_string();
}
}
// Return our response data.
Ok(items)
}
/**
* This function performs a `POST` to the `/users/me/settings/watch` endpoint.
*
* Watch for changes to Settings resources.
*
* **Parameters:**
*
* * `max_results: i64` -- Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries. Optional.
* * `page_token: &str` -- Token specifying which result page to return. Optional.
* * `sync_token: &str` -- Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then.
* If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.
* Learn more about incremental synchronization.
* Optional. The default is to return all entries.
*/
pub async fn watch(
&self,
max_results: i64,
page_token: &str,
body: &crate::types::Channel,
) -> Result<crate::types::Channel> {
let mut query_args: Vec<(String, String)> = Default::default();
if max_results > 0 {
query_args.push(("maxResults".to_string(), max_results.to_string()));
}
if !page_token.is_empty() {
query_args.push(("pageToken".to_string(), page_token.to_string()));
}
let query_ = serde_urlencoded::to_string(&query_args).unwrap();
let url = format!("/users/me/settings/watch?{}", query_);
self.client
.post(&url, Some(reqwest::Body::from(serde_json::to_vec(body)?)))
.await
}
/**
* This function performs a `GET` to the `/users/me/settings/{setting}` endpoint.
*
* Returns a single user setting.
*
* **Parameters:**
*
* * `setting: &str` -- The id of the user setting.
*/
pub async fn get(&self, setting: &str) -> Result<crate::types::Setting> {
let url = format!(
"/users/me/settings/{}",
crate::progenitor_support::encode_path(setting),
);
self.client.get(&url, None).await
}
}