Ta dokumentacja API jest uporządkowana według typu zasobu. Każdy typ zasobu ma co najmniej 1 reprezentację danych i co najmniej 1 metodę.
Typy zasobów
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.datasets
- Users.dataset
- Users.sessions
Użytkownicy.źródła_danych
Szczegółowe informacje o zasobach użytkowników.dataSources znajdziesz na stronie Reprezentowanie zasobów.
Metoda | Żądanie HTTP | Opis |
---|---|---|
O ile nie zaznaczono inaczej, identyfikatory URI odnoszą się do strony https://www.googleapis.com/fitness/v1/users | ||
utwórz |
POST /userId/dataSources
|
Tworzy nowe źródło danych, które jest unikalne dla wszystkich źródeł danych należących do tego użytkownika.
Źródło danych jest niepowtarzalnym źródłem danych z czujników. Źródła danych mogą ujawniać nieprzetworzone dane z czujników na urządzeniach lokalnych lub towarzyszących. Może też udostępniać dane uzyskane, przekształcając lub scalając inne źródła danych. Dla tego samego typu danych może być wiele źródeł danych. Każdy punkt danych w każdym zbiorze danych, który jest umieszczony w interfejsie Fitness API lub z niego odczytywany, ma powiązane źródło danych. Każde źródło danych generuje unikalny strumień aktualizacji zbioru danych z unikalnym identyfikatorem źródła danych. Nie wszystkie zmiany w źródle danych wpływają na identyfikator strumienia danych, więc dane zbierane przez zaktualizowane wersje tej samej aplikacji lub tego samego urządzenia mogą być nadal uznawane za przypisane do tego samego źródła danych. Źródła danych są identyfikowane na podstawie tekstu wygenerowanego przez serwer na podstawie zawartości tworzonego źródła. Podczas wywoływania tej metody nie należy ustawiać pola dataStreamId . Zostanie wygenerowany automatycznie przez serwer w prawidłowym formacie. Jeśli zasada jest ustawiona na dataStreamId , musi ona odpowiadać formatowi generowanemu przez serwer. Ten format stanowi kombinację niektórych pól ze źródła danych i ma określoną kolejność. Jeśli nie uda się, żądanie zakończy się błędem.
Określenie typu danych, który nie jest znany (zaczyna się od &&tt;com.google."), spowoduje utworzenie źródła danych z niestandardowym typem danych. Niestandardowe typy danych mogą odczytywać tylko te aplikacje, które je utworzyły. Typy danych niestandardowych zostały wycofane. Użyj standardowych typów danych. W polu źródła danych uwzględnionego w identyfikatorze źródła danych uwzględniono numer projektu dewelopera, który jest uwierzytelniony podczas tworzenia źródła. Numer projektu dewelopera jest zaciemniony, jeśli odczytuje go inny typ danych publicznych. |
usuń |
DELETE /userId/dataSources/dataSourceId
|
Usuwa określone źródło danych. Żądanie nie powiedzie się, jeśli źródło danych zawiera jakiekolwiek punkty danych. |
pobierz |
GET /userId/dataSources/dataSourceId
|
Zwraca określone źródło danych. |
list |
GET /userId/dataSources
|
Wyświetla wszystkie źródła danych, które są widoczne dla dewelopera za pomocą podanych zakresów OAuth. Lista nie jest wyczerpująca. Użytkownik może mieć prywatne źródła danych, które są widoczne tylko dla innych deweloperów, lub wywołania z innymi zakresami. |
aktualizacja |
PUT /userId/dataSources/dataSourceId
|
Aktualizuje wybrane źródło danych. Nie można zmieniać właściwości dataStreamId , dataType , type , dataStreamName ani device z wyjątkiem właściwości version .
Źródła danych określa dataStreamId .
|
Users.dataSources.dataPointChanges
Szczegółowe informacje o zasobach użytkowników.dataSources.dataPointChanges znajdziesz na stronie Reprezentowanie zasobów.
Metoda | Żądanie HTTP | Opis |
---|---|---|
O ile nie zaznaczono inaczej, identyfikatory URI odnoszą się do strony https://www.googleapis.com/fitness/v1/users | ||
list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
Zapytania dotyczące punktu danych użytkownika zmienia się dla określonego źródła danych. |
Users.dataSources.datasets
Szczegółowe informacje o zasobach użytkowników.dataSources.datasets znajdziesz na stronie Reprezentowanie zasobów.
Metoda | Żądanie HTTP | Opis |
---|---|---|
O ile nie zaznaczono inaczej, identyfikatory URI odnoszą się do strony https://www.googleapis.com/fitness/v1/users | ||
usuń |
DELETE /userId/dataSources/dataSourceId/datasets/datasetId
|
Przeprowadza usunięcie danych wszystkich punktów, których czas rozpoczęcia i zakończenia pokrywa się z zakresem czasu określonym przez identyfikator zbioru danych. W przypadku większości typów danych cały punkt danych zostanie usunięty. W przypadku typów danych, w których przedział czasu zawiera stałą wartość (np. com.google.activity.segment ), a punkt danych znajduje się po obu stronach punktu końcowego zbioru danych, usuwany jest tylko pokrywający się punkt danych.
|
pobierz |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
Zwraca zbiór danych zawierający wszystkie punkty danych, których czas rozpoczęcia i zakończenia pokrywa się z określonym zakresem minimalnego czasu rozpoczęcia i maksymalnego czasu zakończenia zbioru danych. W szczególności każdy punkt danych, którego czas rozpoczęcia jest krótszy niż czas zakończenia zbioru danych lub jego równy, a czas zakończenia jest większy lub równy czasowi rozpoczęcia zbioru danych. |
poprawka |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
Dodaje punkty danych do zbioru danych. Nie trzeba wcześniej tworzyć zbioru danych.
Wszystkie punkty w danym zbiorze danych zostaną zwrócone z kolejnymi wywołaniami w celu pobrania tego zbioru danych. Punkty danych mogą należeć do więcej niż jednego zbioru danych.
Ta metoda nie wykorzystuje semantyki poprawki: podane punkty danych są tylko wstawiane bez zastępowania danych. |
Użytkownicy.zbiór_danych
Szczegółowe informacje o zasobie użytkowników.dataset znajdziesz na stronie reprezentowania zasobów.
Metoda | Żądanie HTTP | Opis |
---|---|---|
O ile nie zaznaczono inaczej, identyfikatory URI odnoszą się do strony https://www.googleapis.com/fitness/v1/users | ||
zagregowane |
POST /userId/dataset:aggregate
|
Agreguje dane określonego typu lub strumień do zasobników podzielonych przez określony typ granicy. Zbiorcze zbiory danych różnego typu i z wielu źródeł mogą być zbierane w ramach jednego typu zasobnika na żądanie. |
Użytkownicy.sesje
Więcej informacji o zasobach użytkowników.sesje znajdziesz na stronie Reprezentowanie zasobów.
Metoda | Żądanie HTTP | Opis |
---|---|---|
O ile nie zaznaczono inaczej, identyfikatory URI odnoszą się do strony https://www.googleapis.com/fitness/v1/users | ||
usuń |
DELETE /userId/sessions/sessionId
|
Usuwa sesję określoną w podanym identyfikatorze sesji. |
list |
GET /userId/sessions
|
Wyświetla listę utworzonych wcześniej sesji. |
aktualizacja |
PUT /userId/sessions/sessionId
|
Aktualizuje lub wstawia dane danej sesji. |