Kimliği doğrulanmış kullanıcının tüm kullanıcı ayarlarını döndürür. Hemen deneyin veya bir örneği inceleyin.
İstek
HTTP isteği
GET https://www.googleapis.com/calendar/v3/users/me/settings
Parametreler
Parametre adı | Değer | Açıklama |
---|---|---|
İsteğe bağlı sorgu parametreleri | ||
maxResults |
integer |
Bir sonuç sayfasında döndürülen maksimum giriş sayısı. Değer varsayılan olarak 100 giriştir. Sayfa boyutu hiçbir zaman 250 girişten büyük olamaz. İsteğe bağlı. |
pageToken |
string |
Döndürülecek sonuç sayfasını belirten jeton. İsteğe bağlı. |
syncToken |
string |
nextSyncToken alanından alınan jeton, önceki liste isteğinden sonuçların son sayfasında döndürülür. Bu işlem, bu liste isteğinin sonucunun yalnızca o tarihten bu yana değişen girişleri içermesini sağlar. syncToken süresi dolarsa sunucu 410 GONE yanıt koduyla yanıt verir ve istemci depolama alanını temizlemeli ve syncToken olmadan tam senkronizasyon gerçekleştirmelidir. Artımlı senkronizasyon hakkında daha fazla bilgi edinin. İsteğe bağlıdır. Varsayılan değer tüm girişleri döndürmektir. |
Yetkilendirme
Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektiriyor:
Kapsam |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.settings.readonly |
Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.
İstek metni
Bu yöntemi içeren bir istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{ "kind": "calendar#settings", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ settings Resource ] }
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
kind |
string |
Koleksiyonun türü ("calendar#settings "). |
|
etag |
etag |
Koleksiyonun etiketi. | |
items[] |
list |
Kullanıcı ayarlarının listesi. | |
nextPageToken |
string |
Jeton, bu sonucun sonraki sayfasına erişmek için kullanıldı. Başka sonuç yoksa bu durumda yoksayılır, bu durumda nextSyncToken sağlanır. |
|
nextSyncToken |
string |
Jeton daha sonra, bu sonucun döndürülmesinden sonra değişen girişleri almak için kullanılır. Daha fazla sonuç varsa yoksayılır, bu durumda nextPageToken sağlanır. |
Örnekler
Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).
Java
Java istemci kitaplığını kullanır.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Setting; import com.google.api.services.calendar.model.Settings; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over all user settings Settings settings = service.settings().list().execute(); for (Setting setting : settings.getItems()) { System.out.println(setting.getId() + ": " + setting.getValue()); }
Python
Python istemci kitaplığını kullanır.
settings = service.settings().list().execute() for setting in settings['items']: print '%s: %s' % (setting['id'], setting['value'])
PHP
PHP istemci kitaplığını kullanır.
$settings = $service->settings->listSettings(); foreach ($settings->getItems() as $setting) { echo $setting->getId() . ': ' . $setting->getValue(); }
Ruby
Ruby istemci kitaplığı kullanır.
result = client.list_settings result.items.each do |e| print e.id + ": " + e.value + "\n" end
Deneyin.
Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.