Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W tym kroku określasz konto Google Ads, do którego chcesz wysyłać wywołania interfejsu API. Konto może być kontem produkcyjnym (aktywnym) lub kontem testowym. Każde podejście ma swoje zalety i wady.
Konta produkcyjne
Konta testowe
Zalety
Łatwiejsze pisanie i testowanie kodu, który działa w odniesieniu do określonych treści na koncie.
Łatwiejsze pisanie i testowanie kodu, który przetwarza dane raportowania na żywo.
Konta testowe nie wyświetlają reklam, więc błędy programowania nie będą miały wpływu na Twoje aktywne kampanie.
Działa z tokenami deweloperskimi o poziomie dostępu Test.
Wady
Błąd programowania w fazie rozwoju może mieć wpływ na wyświetlanie aktywnych kampanii, co może prowadzić do problemów, takich jak niska skuteczność kampanii, nieprawidłowe wyświetlanie reklam lub straty finansowe.
Aby wykonywać wywołania interfejsu API, token programisty musi mieć co najmniej poziom dostępu Podstawowy.
Aby przetestować kod, który działa w odniesieniu do określonej zawartości konta, musisz odtworzyć kampanie na kontach testowych.
Konta testowe nie wyświetlają reklam, więc funkcje związane z wyświetlaniem reklam w wersji opublikowanej, takie jak statystyki raportowania, błędy naruszenia zasad czy przetwarzanie importów konwersji offline, nie są obsługiwane, co utrudnia testowanie tych funkcji.
Podczas tworzenia aplikacji zalecamy korzystanie z konta testowego, o ile to możliwe. Instrukcje znajdziesz w artykule Tworzenie kont testowych i kampanii.
Możesz też skonfigurować konto produkcyjne z niskim budżetem, np. 1 PLN dziennie, aby testować funkcje, które nie są obsługiwane na koncie testowym.
Wybór zestawu funkcji
Podczas wybierania konta do wywoływania interfejsu API należy też wziąć pod uwagę listę funkcji, których chcesz używać w interfejsie API. Nawet jeśli zdecydujesz się używać konta produkcyjnego, niektóre funkcje są specyficzne dla konta, np.:
Aby korzystać z funkcji płatności, musisz mieć konto z fakturowaniem miesięcznym.
Dostęp do niektórych nowych funkcji na koncie może być ograniczony przez listy dozwolonych.
Zanim sfinalizujesz konto, aby wykonywać wywołania interfejsu API, zapoznaj się z dokumentacją konkretnej funkcji, aby upewnić się, że nie ma ona dodatkowych ograniczeń.
Określanie identyfikatora klienta logowania i identyfikatora klienta
Aby wykonać wywołanie interfejsu API na koncie klienta Google Ads, musisz przyznać kontu usługi dostęp do konta klienta i odpowiednie uprawnienia bezpośrednio lub za pomocą połączonego konta menedżera. Aby to zrobić, musisz mieć dostęp administracyjny do konta klienta.
Zacznij od zalogowania się na konto Google Ads jako administrator. W niektórych przypadkach możesz mieć do wyboru więcej niż jedno konto klienta. Wybrane konto określa identyfikator klienta logowania, który jest wymaganym nagłówkiem w przypadku niektórych wywołań interfejsu API.
Po zidentyfikowaniu klienta Google Ads, do którego chcesz wysyłać wywołania interfejsu API, zanotuj te informacje:
10-cyfrowy identyfikator klienta konta klienta, na którym chcesz wykonywać wywołania interfejsu API. Czasami określa się go jako klienta operacyjnego.
10-cyfrowy identyfikator klienta konta klienta, na którym jesteś zalogowany(-a).
Jeśli jesteś zalogowany na koncie klienta, identyfikator klienta logowania jest taki sam jak identyfikator klienta. Jeśli zalogujesz się na konto menedżera klienta obsługującego, identyfikator klienta logowania będzie identyfikatorem klienta konta menedżera.
Przyznaj dostęp do konta usługi
Zaloguj się na konto Google Ads jako administrator i otwórz Administracja > Dostęp i bezpieczeństwo.
Na karcie Użytkownicy kliknij przycisk +.
Wpisz adres e-mail konta usługi w polu E-mail. Wybierz odpowiedni poziom dostępu do konta i kliknij przycisk Dodaj konto. Pamiętaj, że poziom dostępu do poczty e-mail nie jest obsługiwany w przypadku kont usługi.
Konto usługi otrzymuje dostęp.
Domyślnie nie możesz przyznać kontu usługi dostępu administratora. Jeśli wywołania interfejsu API wymagają dostępu administratora, możesz go uzyskać w ten sposób.
Kliknij strzałkę w dół obok poziomu dostępu konta usługi w kolumnie Poziom dostępu.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 UTC."],[[["\u003cp\u003eChoose a Google Ads account (production or test) to make API calls, noting its email address for generating OAuth 2.0 refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eTest accounts are recommended for development to prevent affecting live campaigns; however, they don't support features related to live serving.\u003c/p\u003e\n"],["\u003cp\u003eProduction accounts, with a low budget, can be used to test features unsupported by test accounts, but a programming bug can affect live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eEnsure the selected account supports the desired features as some features have account-specific restrictions.\u003c/p\u003e\n"],["\u003cp\u003eTo make API calls, you need access to the customer account, the 10-digit customer ID, email address for OAuth 2.0 token generation, and the 10-digit login customer ID.\u003c/p\u003e\n"]]],[],null,["# Prepare the customer account\n\n**Note:** The current step of this tutorial depends on the [type of application](/google-ads/api/docs/get-started/choose-application-type) you are building. We strongly recommend using service account to make API calls. However, the user authentication option is also provided as an alternative. The rest of this tutorial will be customized based on your choice. \nService accounts User authentication\n\nIn this step, you identify a Google Ads account to make API calls to. The account\ncan either be a production (live) account or a test account. Each approach has\nits advantages and disadvantages.\n\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | ##### Production accounts | ##### Test accounts |\n| ##### Advantages | - Easier to write and test code that works against specific account contents. - Easier to write and test code that processes live reporting data. | - Test accounts *don't* serve ads, hence programming bugs won't affect your live campaigns. - Works with developer tokens that have Test Access level. |\n| ##### Disadvantages | - A programming bug in the development phase could affect live campaign serving, leading to issues such as poor campaign performance, incorrect serving, or financial losses. - The developer token should have at least the Basic Access level to in order to make API calls. | - You must reconstruct campaigns within test accounts to test code that works against specific account contents. - Since test accounts don't serve ads, features related to live serving such as reporting stats, policy violation errors, or processing offline conversion imports are not supported, making it difficult to test those features. |\n\nWe recommend using a test account while developing your application when\npossible. For instructions, see [Create test accounts and\ncampaigns](/google-ads/api/docs/best-practices/test-accounts#create).\n\nAn alternative is to set up a production account with a low account budget,\nsuch as $1/day, explicitly for testing features that are not supported by a\ntest account.\n\nChoice of feature set\n---------------------\n\nWhen choosing an account for making API call, an additional consideration is\nthe list of features you'd want to use with the API. Even if you choose to use\na production account, there are some features that are account-specific, for\nexample:\n\n- For billing features, you need an account that is on monthly invoicing.\n- Some new features in the account might be restricted by allowlists.\n\nBefore finalizing the account to make API calls against, check the\ndocumentation of the specific feature to make sure that the feature doesn't\nhave additional restrictions.\n\nIdentify the login customer ID and customer ID\n----------------------------------------------\n\nTo make an API call to a Google Ads customer, you must grant access and\nappropriate permissions to your service account to the customer account\neither directly or through a linked manager account. To do this, you need\nadministrator access to the customer account.\n\nStart by signing in to your Google Ads account as an administrator. In some cases,\nyou might have more than one customer account to choose from. The account you\nselect establishes the login customer ID, which is a required header for some\nAPI calls.\n\nAfter you've identified the Google Ads customer to make API calls to, note the\nfollowing details:\n\n- The 10-digit customer ID of the customer account to which you plan to make\n API calls against. This is sometimes referred to as the operating customer.\n\n- The 10-digit login customer ID of the customer account you're signed in to.\n If you're signed in to the operating customer, the login customer ID is the\n same as the customer ID. If you signed into a manager account of the\n operating customer, the login customer ID is the customer ID of the manager\n account.\n\nGrant access to the service account\n-----------------------------------\n\n1. While signed in to your Google Ads account as an administrator, navigate to\n **Admin \\\u003e Access and security**.\n\n2. Click the **+** button under the **Users** tab.\n\n3. Type the service account email address into the **Email** input box. Select\n the appropriate level of account access level and click the **Add account**\n button. Note that Email access level is not supported for service accounts.\n\n4. The service account is granted access.\n\nBy default, you cannot grant administrator access to a service account. If your\nAPI calls require administrator access, you can upgrade the access as follows.\n\n1. Click the drop-down arrow next to the access level of the service account\n in the **Access level** column.\n\n2. Select **Admin** from the drop-down list."]]
