Google Cloud (GCP) — usługi, integracje

Google Cloud API pozwala aplikacjom korzystać z usług Google Cloud. Platforma aplikacji biznesowych Google Cloud łączy zarządzanie API przez Apigee, tworzenie aplikacji bez kodu przez AppSheet oraz uczenie maszynowe.¹
Ten artykuł prowadzi przez konfigurację, wywołania API, typowe błędy i zadania w chmurze. Prototyp w AppSheet można bezpłatnie testować z maksymalnie 10 użytkownikami, wliczając twórcę aplikacji².

Czym jest Google Cloud API i jak działa?

Aplikacja wysyła żądanie przez Google Cloud API i odbiera odpowiedź usługi. W Agent Platform API interfejs REST porządkuje zasoby hierarchicznie. gRPC i biblioteki klienckie grupują natomiast operacje według usług.³
Sposoby wywołania różnią się formatem komunikacji:

Dane w tabeli: 4

Żądanie wskazuje operację i zasób, a odpowiedź przynosi wynik albo informację o błędzie. Przy wyborze sposobu wywołania weź pod uwagę strukturę żądań, strumieniowanie oraz obowiązki związane z własnym klientem.
Kody HTTP z zakresu 4xx oznaczają błędy po stronie klienta. Kody 5xx wskazują błędy po stronie serwera⁵.

Czym są endpointy, metody i wersje Google Cloud API?

Endpoint wskazuje adres usługi, metoda określa operację, a wersja – wariant interfejsu. Agent Platform API akceptuje w REST nazwy pól zapisane zarówno w camel case, jak i snake case.³
Pole `displayName` można więc zapisać w żądaniu REST także jako `display_name`³.

• Endpoint kieruje żądanie aplikacji do usługi obsługującej wskazany zasób.
• Metoda określa działanie na zasobie; dobierz ją do zadania przed wysłaniem żądania.
• Wersja v1beta1 Agent Platform API udostępnia najnowsze funkcje w wersji zapoznawczej.³

Najpierw ustal zasób i operację, a dopiero potem wybierz wersję interfejsu. O wyborze rozstrzyga funkcja, której potrzebuje aplikacja.
Do tłumaczenia z glosariuszem wybierz Cloud Translation Advanced (v3): Basic (v2) nie udostępnia tej funkcji⁶.

Jak rozpoznać i rozwiązać typowe błędy odpowiedzi API?

Odpowiedź Google Cloud API analizuj przez status żądania, komunikat błędu i sposób wywołania. Interfejs REST Agent Platform API nie obsługuje strumieniowania. Własny klient REST wymaga też implementacji uwierzytelniania i ponawiania prób.³
gRPC pozwala na wywołania strumieniowe, jeśli dana metoda je udostępnia³.

• Błąd uwierzytelniania wymaga sprawdzenia danych dostępowych klienta oraz sposobu przekazania ich w żądaniu.
• Błąd uprawnień oznacza potrzebę sprawdzenia, czy tożsamość wywołująca może wykonać operację na wskazanym zasobie.
• Błąd żądania wymaga porównania metody, pól i identyfikatora zasobu z dokumentacją wybranego interfejsu.
• Błąd przejściowy skłania do sprawdzenia zasad ponawiania prób, aby klient nie powtarzał żądań bez kontroli.

Własny klient gRPC Agent Platform API wymaga kodu wygenerowanego z buforów protokołu udostępnionych przez Google. Trzeba też zaimplementować uwierzytelnianie i ponawianie prób.³
Po usunięciu ustalonej przyczyny błędu ponownie wywołaj tę samą operację. Status gRPC 14 (`UNAVAILABLE`) może oznaczać przejściowy problem z usługą; wtedy warto rozważyć ponowienie wywołania⁷.

Jak sprawdzić limity, wykorzystanie i przekroczenia limitów API?

Limity Google Cloud API sprawdzaj dla konkretnej usługi i projektu. Porównaj przydział z wykorzystaniem oraz błędami żądań. W ten sposób odróżnisz przekroczenie limitu od problemu z uprawnieniami lub treścią żądania.
Domyślny limit Cloud Vision API wynosi 1800 żądań na minutę na projekt, poza osobno wymienionymi typami żądań⁸.

• Przydział API odczytaj w ustawieniach limitów usługi dla projektu, z którego aplikacja wysyła żądania.
• Wykorzystanie API porównaj z przydziałem dla tej samej operacji i tego samego projektu.
• Przekroczenie limitu rozpoznaj po komunikacie odpowiedzi i porównaj z ruchem aplikacji; potem ogranicz wywołania albo dostosuj przydział.

Odpowiedzi, uprawnienia i limity analizuj osobno. Każdy z tych obszarów wymaga innego działania.
Kod HTTP 403 (`PERMISSION_DENIED`) kieruje uwagę na uprawnienia, a HTTP 429 (`RESOURCE_EXHAUSTED`) może wskazywać między innymi przekroczenie limitu⁹.

Jak wybrać i uruchomić Google Cloud API do konkretnego zadania?

Interfejs Google Cloud API dobierz do operacji, którą ma wykonać aplikacja. Następnie przygotuj projekt, dostęp i próbne wywołanie. Platforma aplikacji biznesowych Google Cloud udostępnia narzędzia nadzoru i zabezpieczenia.¹
Identyfikator projektu (`project ID`) potrzebny do integracji musi mieć od 6 do 30 znaków¹⁰.

Konfigurację zacznij od wybrania usługi odpowiadającej zadaniu. Włącz jej API w projekcie, nadaj tożsamości aplikacji potrzebne uprawnienia i przetestuj żądanie. Wynik pokaże, czy aplikacja uzyskała dostęp do właściwej usługi.
Jeśli test zwróci HTTP 403 (`PERMISSION_DENIED`), sprawdź uprawnienie potrzebne tożsamości aplikacji do wykonania operacji⁹.

Jak skonfigurować uwierzytelnianie i uprawnienia do API?

Uwierzytelnianie przypisuje wywołaniu tożsamość, a uprawnienia określają dostępne jej operacje. To dwa odrębne elementy konfiguracji.
Token dostępu OAuth 2.0 wygenerowany dla konta usługi jest domyślnie ważny przez godzinę, czyli 3600 sekund¹¹.

• Projekt Google Cloud stanowi kontekst wywołań API przez aplikację; wybierz projekt, w którym ma działać integracja.
• Tożsamość aplikacji pozwala uwierzytelnić żądania; skonfiguruj ją zgodnie ze sposobem uruchamiania aplikacji.
• Uprawnienia IAM określają dostęp do zasobów; przypisz je tożsamości dla operacji wymaganych przez aplikację.
• Dostęp testowy potwierdza możliwość wykonania zadania; zweryfikuj go wywołaniem potrzebnej operacji.

Poprawna konfiguracja pozwala aplikacji wykonać dozwoloną operację bez dostępu do niepowiązanych zasobów¹².

Jak wywołać API przez REST lub bibliotekę kliencką?

Google Cloud API można wywołać żądaniem REST albo metodą biblioteki klienckiej. Obie drogi wymagają właściwego projektu, tożsamości i operacji.
Przykładem REST w Cloud Translation API jest żądanie POST do operacji `translateText` w wersji v3¹³.

Tabela zestawia czynności potrzebne do przygotowania obu sposobów wywołania.

• Wywołanie REST wysyła żądanie na adres operacji z wymaganymi polami i danymi uwierzytelniającymi.
• Biblioteka kliencka udostępnia metodę operacji w języku aplikacji po dodaniu biblioteki do projektu.
• Odpowiedź API zawiera wynik albo komunikat błędu; obsłuż w aplikacji oba przypadki.

Próbne wywołanie tej samej operacji pozwala sprawdzić wybrany sposób integracji.
W próbnym wywołaniu REST `translateText` kod HTTP 200 oznacza powodzenie żądania¹⁴.

Które API wybrać do planowanego zadania?

Interfejs dobierz do czynności na danych: rozpoznania tekstu na obrazie albo tłumaczenia odczytanego tekstu. W opisanym ćwiczeniu skrypt w Pythonie używa Cloud Vision API do wyodrębnienia tekstu z obrazów. Następnie Translation API tłumaczy ten tekst.¹⁵
Plik obrazu przekazany do Cloud Vision API nie może przekroczyć 20 MB; dla żądania JSON obowiązuje osobny limit 10 MB⁸.

Tabela pokazuje kolejność przetwarzania obrazu i usługę przypisaną do każdego etapu.

Apigee służy do zarządzania pełnym cyklem życia API. Nie wyodrębnia ani nie tłumaczy tekstu.¹
Wybierz Apigee do zarządzania interfejsem, a API wykonujące operację – do rodzaju danych.

Jak sprawdzić, czy wybrane API jest włączone i działa?

Stan Google Cloud API sprawdź w projekcie. Działanie potwierdzisz dopiero próbnym wywołaniem wymaganej operacji.
Przykładowo kod HTTP 200 oznacza powodzenie opisanego wcześniej wywołania REST `translateText`.

• Stan API odczytaj w wykazie usług projektu i upewnij się, że wybrany interfejs jest włączony.
• Żądanie próbne wyślij przy użyciu tożsamości, z której korzysta aplikacja.
• Odpowiedź żądania porównaj z oczekiwanym wynikiem; komunikat błędu pomoże ustalić, czy problem dotyczy dostępu, żądania czy limitu.

Polecenie gcloud api-gateway gateways służy do zarządzania bramami Cloud API Gateway.¹⁶
Stan bramy i działanie docelowego API sprawdzaj osobno. O działaniu API świadczy odpowiedź na jego wywołanie.

Aktualności Google Cloud, dobre praktyki i ścieżki certyfikacji

Dokumentację Google Cloud, komunikaty o zmianach i materiały szkoleniowe dobieraj do konkretnego zadania. Przy wdrożeniu liczą się zmiany wersji interfejsu, zasad dostępu i dostępności usługi w regionie. Różnicę między wersjami pokazuje glosariusz: działa w Cloud Translation Advanced (v3), ale nie w Basic (v2).

Każdy rodzaj informacji odpowiada na inne pytanie. Zestawiaj go więc z decyzją, którą trzeba podjąć.

Co oznacza rozwój infrastruktury Google Cloud na zachodnim wybrzeżu Ameryki Północnej?

Rozwój infrastruktury Google Cloud na zachodnim wybrzeżu Ameryki Północnej oceniaj przez dostępność usługi w regionie, lokalizację danych i opóźnienia. Sama rozbudowa nie oznacza, że każda funkcja API działa w tej lokalizacji. Dostępność trzeba odnieść do wybranej wersji, na przykład v3 używanej przy tłumaczeniu z glosariuszem.

Wybór regionu powinien uwzględniać miejsce przechowywania danych i położenie systemów, z którymi łączy się aplikacja.
Firmie obsługującej użytkowników w Polsce komunikat o Ameryce Północnej nie zastąpi oceny regionu, w którym ma działać jej aplikacja.

Gdzie śledzić zmiany w usługach Google Cloud?

Zmiany w usługach Google Cloud śledź w dokumentacji danej usługi i jej komunikatach o wydaniach. Porównuj zmienioną funkcję z wersją API używaną przez aplikację oraz konfiguracją projektu. Agent Platform API udostępnia najnowsze funkcje zapoznawcze w wersji v1beta1.

Dokumentacja API opisuje wymagania wobec żądań i uprawnień. Komunikaty o wydaniach wskazują natomiast zakres zmian.
Po zmianie istotnej dla integracji wykonaj próbne wywołanie operacji używanej przez aplikację¹⁷.

Jak śledzić ogłoszenia Google Cloud dotyczące AI?

Ogłoszenia Google Cloud dotyczące AI oceniaj przez pryzmat usługi i zadania wykonywanego przez aplikację.
Przy rozpoznawaniu tekstu uwzględnij limity Cloud Vision API: 20 MB dla pliku obrazu i 10 MB dla żądania JSON.

• Komunikat o funkcji AI przypisz do konkretnej usługi, zamiast uznawać go za zmianę całej platformy.
• Dokumentację usługi porównaj z komunikatem, zwracając uwagę na dostęp, obsługiwane operacje i regiony.
• Integrację aplikacji przetestuj na używanej operacji przed zmianą środowiska produkcyjnego.

Ogłoszenie wpływa na wdrożenie wtedy, gdy dotyczy usługi i operacji używanych przez aplikację.

Jak podejść do szkoleń i certyfikacji Google Cloud?

Szkolenia i certyfikację Google Cloud dobierz do obowiązków: konfiguracji projektów, tworzenia aplikacji albo utrzymania infrastruktury.
Jeśli praca obejmuje integrację API, ćwiczenia powinny uwzględniać używane wersje, na przykład v3 operacji `translateText`.

• Zakres obowiązków spisz na podstawie zadań wykonywanych w Google Cloud¹⁸.
• Program szkolenia porównaj z obowiązkami, aby ćwiczenia obejmowały używane usługi.
• Wymagania certyfikacji zestaw z umiejętnościami potrzebnymi na stanowisku przed rozpoczęciem przygotowań.

Ścieżkę szkoleniową dopasuj do pracy z konkretnymi usługami, a nie do samej nazwy platformy.

Otwarte testy API uczenia maszynowego – co oznaczała faza beta?

Faza beta API uczenia maszynowego oznaczała testowanie usługi przed ogólną dostępnością. Nie mówiła nic o jednakowym statusie wszystkich funkcji. Cloud Natural Language API umożliwia analizę ogólnego sentymentu fragmentu tekstu.¹⁹
Sentyment określa wydźwięk tekstu; aplikacja może wykorzystać go jako wynik analizy.

Cloud Speech API osiągnęło status ogólnej dostępności.¹⁹ Do jego wcześniejszej wersji alfa zapisało się ponad 5 000 firm.¹⁹
Planując integrację, przypisuj status wersji do konkretnej usługi, nie do wszystkich API uczenia maszynowego.

Jak uruchomić laboratorium i zalogować się do konsoli Google Cloud?

Laboratorium Google Cloud uruchom według instrukcji ćwiczenia. Do konsoli zaloguj się danymi wskazanymi dla tego laboratorium. Przed pracą upewnij się, że konsola pokazuje właściwy projekt; jego identyfikator ma od 6 do 30 znaków.

• Instrukcja laboratorium podaje sposób uruchomienia środowiska i dane logowania; otwórz ją przed rozpoczęciem pracy.
• Środowisko laboratoryjne uruchom w miejscu wskazanym przez organizatora ćwiczenia.
• Konsola Google Cloud wymaga konta przeznaczonego do laboratorium; otwórz ją i zaloguj się tym kontem.
• Projekt Google Cloud wybierz według instrukcji ćwiczenia, zanim zaczniesz konfigurować usługi lub wywoływać API.

Laboratorium jest gotowe do pracy, gdy w konsoli widzisz projekt przypisany do ćwiczenia i możesz otworzyć potrzebną usługę.

Jak skonfigurować konto usługi do obsługi API uczenia maszynowego, BigQuery i Cloud Storage?

Konto usługi skonfiguruj jako tożsamość aplikacji. Dostęp do API uczenia maszynowego, BigQuery i Cloud Storage nadaj osobno dla potrzebnych operacji. W opisanym ćwiczeniu konto usługi i plik poświadczeń uwierzytelniają aplikację w Pythonie korzystającą z Google Cloud.¹⁵
Token dostępu OAuth 2.0 dla konta usługi jest domyślnie ważny przez 3600 sekund.

• Projekt Google Cloud jest miejscem utworzenia konta usługi i uruchamiania aplikacji; wybierz właściwy projekt.
• Konto usługi zapewnia aplikacji odrębną tożsamość; utwórz je dla jej żądań.
• Interfejsy API wymagane przez aplikację włącz w projekcie, z którego będzie wysyłać żądania.
• Uprawnienia dostępu przypisz kontu usługi oddzielnie dla wymaganych operacji na API uczenia maszynowego, danych BigQuery i obiektach Cloud Storage.
• Poświadczenia aplikacji skonfiguruj zgodnie ze sposobem jej uruchamiania; chroń plik poświadczeń przed umieszczeniem w repozytorium kodu.
• Wywołanie testowe wykonaj z aplikacji dla każdej usługi, z której ma ona korzystać.

Konfiguracja jest gotowa, gdy aplikacja uwierzytelnia się jako konto usługi i wykonuje tylko operacje objęte przyznanymi uprawnieniami.

Ceny i warunki sprawdzone u źródeł: październik 2026.