Przykład zmiany harmonogramu

W tym przykładzie pokazujemy, jak wywoływać interfejs API za pomocą biblioteki Pythona requests, używając klucza interfejsu API do uwierzytelniania. Aby jej użyć:

• Zainstaluj bibliotekę Pythona requests. W wierszu poleceń: pip install requests.
• Zapisz na komputerze poniższy program Pythona, nazywając go example.py.
• Zapisz plik example_request.json w tym samym katalogu, w którym znajduje się program (to przykładowe żądanie JSON).
• Utwórz plik credentials.json w tym samym katalogu, w którym znajduje się Twój program, {"key": "your_api_key"}
• Uruchom przykład z poziomu wiersza poleceń: python example.py.

# example.py
import json
import requests

def run_example():
    """Calls the OR API to solve a shift scheduling problem."""
    
    # Endpoint for the workforce scheduling solver in the OR API.
    end_point = "https://optimization.googleapis.com/v1/scheduling:solveShiftScheduling"
    
    # Read the API Key from a JSON file with the format:
    # {"key": "your_api_key"}
    with open("credentials.json") as f:
        credentials = json.load(f)
        api_key = credentials["key"]

    # Load the JSON file with the request.
    with open("example_request.json", "r") as f:
        json_request = json.load(f)

    # Call the API post method.
    response = requests.post(f"{end_point}?key={api_key}", json=json_request)

    # Process the response.
    if response.ok:
        solution = json.loads(response.content)
        with open("example_response.json", "w") as f:
            json.dump(solution, f, indent=2)
        print(solution)
    else:
        error = json.loads(response.content)["error"]
        print(f'Status code {error["code"]}: {error["message"]}')

if __name__ == "__main__":
    run_example()

Jak ustawić terminy?

Termin określa maksymalny czas działania, jaki powinno zająć wywołanie interfejsu API. Użytkownik może ustawiać terminy zarówno dla klienta, jak i dla serwera. W kontekście interfejsu API LUB na serwer jest bardziej przydatny, bo informuje serwer backendu, w jaki sposób ma dużo czasu na otrzymanie żądania, uruchomienie bazowego rozwiązania i zwrócenie . Natomiast terminy klientów służą natomiast do ustawienia maksymalnego czasu aplikacja kliencka (tj. aplikacja wywołująca interfejs LUB API) wykona oczekiwanie na odpowiedź przed przekroczeniem limitu czasu.

Ten fragment kodu ustawia termin dla klienta i serwera w nagłówków sesji żądania. Termin dla klienta jest ustawiony na 60 sekund. Termin na serwerze powinien być krótszy niż termin dla klienta, aby uwzględnić koszty komunikacji. Wyznaczamy termin serwera na 95% wszystkich zadań ale ten czas może się różnić w zależności od zgłoszenia. Zwróć uwagę, że interfejs API również został przeniesiony do nagłówków sesji, aby wywołać session.post(...) jest bardziej przejrzysty.

# Call the API post method.
session = requests.Session()
client_deadline_seconds = 60
server_deadline_seconds = 0.95 * client_deadline_seconds
session.headers = {
    "Content-Type": "application/json",
    "Connection": "keep-alive",
    "Keep-Alive": f"timeout={client_deadline_seconds}, max=1",
    "X-Server-Timeout": f"{server_deadline_seconds}",
    "X-Goog-Api-Key": api_key,
}
response = session.post(end_point, json=json_request, timeout=client_deadline_seconds)