Colors: get

Affiche les définitions de couleur pour les agendas et les événements. Essayez maintenant ou voir un exemple

Requête

Requête HTTP

GET https://www.googleapis.com/calendar/v3/colors

Autorisation

Cette requête autorise l'autorisation avec au moins l'une des portées suivantes:

Portée
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendarlist
https://www.googleapis.com/auth/calendar.calendarlist.readonly
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie une ressource "Colors" dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque cliente Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Colors;
import com.google.api.services.calendar.model.ColorDefinition;

import java.util.Map;
// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve color definitions for calendars and events
Colors colors = service.colors().get().execute();

// Print available calendar list entry colors
for (Map.Entry<String, ColorDefinition> color : colors.getCalendar().entrySet()) {
  System.out.println("ColorId : " + color.getKey());
  System.out.println("  Background: " + color.getValue().getBackground());
  System.out.println("  Foreground: " + color.getValue().getForeground());
}

// Print available event colors
for (Map.Entry<String, ColorDefinition> color : colors.getEvent().entrySet()) {
  System.out.println("ColorId : " + color.getKey());
  System.out.println("  Background: " + color.getValue().getBackground());
  System.out.println("  Foreground: " + color.getValue().getForeground());
}

Python

Utilise la bibliothèque cliente Python.

colors = service.colors().get().execute()

# Print available calendarListEntry colors.
for id, color in colors['calendar'].iteritem():
  print 'colorId: %s' % id
  print '  Background: %s' % color['background']
  print '  Foreground: %s' % color['foreground']
# Print available event colors.
for id, color in colors['event'].iteritem():
  print 'colorId: %s' % id
  print '  Background: %s' % color['background']
  print '  Foreground: %s' % color['foreground']

PHP

Utilise la bibliothèque cliente PHP.

$colors = $service->colors->get();

// Print available calendarListEntry colors.
foreach ($colors->getCalendar() as $key => $color) {
  print "colorId : {$key}\n";
  print "  Background: {$color->getBackground()}\n";
  print "  Foreground: {$color->getForeground()}\n";
}
// Print available event colors.
foreach ($colors->getEvent() as $key => $color) {
  print "colorId : {$key}\n";
  print "  Background: {$color->getBackground()}\n";
  print "  Foreground: {$color->getForeground()}\n";
}

Ruby

Utilise la bibliothèque cliente Ruby.

result = client.get_color()

# Print available calendarListEntry colors.
result.calendar.keys.each do |key|
  print "colorId: #{key}\n"
  print "  Background: #{result.calendar[key].background}\n"
  print "  Foreground: #{result.calendar[key].foreground}\n"
end

# Print available event colors.
result.event.keys.each do |key|
  print "colorId: #{key}\n"
  print "  Background: #{result.event[key].background}\n"
  print "  Foreground: #{result.event[key].foreground}\n"
end

.NET

Utilise la bibliothèque cliente.NET.

Colors colors = service.Colors.Get().Fetch();

// Print available calendarListEntry colors.
foreach (KeyValuePair<String, ColorDefinition> color in colors.Calendar) {
  System.out.println("ColorId : " + color.Key);
  System.out.println("  Background: " + color.Value.Background);
  System.out.println("  Foreground: " + color.Value.Foreground);
}
// Print available event colors.
foreach (KeyValuePair<String, ColorDefinition> color in colors.Event) {
  System.out.println("ColorId : " + color.Key);
  System.out.println("  Background: " + color.Value.Background);
  System.out.println("  Foreground: " + color.Value.Foreground);
}

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.