소개
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Ads API는 대규모 또는 복잡한 Google Ads 계정 및 캠페인을 관리하는 데 사용됩니다. 고객 수준에서 키워드 수준까지 계정을 관리하는 소프트웨어를 빌드할 수 있습니다. 몇 가지 일반적인 사용 사례는 다음과 같습니다.
- 자동 계정 관리
- 맞춤 보고서
- 인벤토리에 따른 광고 관리
- 스마트 자동 입찰 전략 관리
Google Ads API가 적합한 제품인가요?
Google에서는 Google Ads 계정을 자동화하는 데 도움이 되는 여러 제품을 제공합니다. 다음은 일반적인 시나리오와 요구사항에 가장 적합한 Google 제품 목록입니다.
| 시나리오 |
권장사항 |
| 자체 소프트웨어 제품을 빌드하거나 Google Ads API와 통합하려는 개발자입니다. 코드를 작성하고 서버 및 데이터베이스를 포함한 소프트웨어 인프라를 관리하는 데 익숙합니다. |
Google Ads API를 사용합니다. |
| 코드를 작성하는 데는 익숙하지만 자체 소프트웨어 인프라를 관리하고 싶지는 않은 개발자입니다. |
Google Ads 스크립트를 사용합니다. |
| 저는 개발자는 아니지만 Google Ads를 자동화하기 위해 프로그래밍을 배우는 데 시간을 투자할 의향이 있습니다. |
Google Ads 스크립트를 사용합니다. |
| 추가 분석을 위해 Google Ads 보고서를 다운로드하려는 데이터 분석가 (또는 유사한 역할)입니다. |
BigQuery Data Transfer Service를 사용합니다.
Google Ads 이전에 대한 지원이 제공됩니다. |
| Google Ads를 일괄적으로 관리하고 싶지만 코드를 작성하고 싶지는 않습니다. |
자동 규칙,
일괄 업로드 또는 Google Ads 에디터를 사용합니다.
|
기본 요건
Google Ads API 호출을 수행하려면 다음 세부정보가 있어야 합니다. 이 튜토리얼의 나머지 부분에서는 이러한 각 항목을 획득하는 방법을 설명합니다.
- Google Ads 관리자 계정: Google Ads API를 신청하려면 Google Ads 관리자 계정이 필요합니다.
개발자 토큰: 이 토큰을 사용하면 앱이 Google Ads API에 연결할 수 있습니다. 각 개발자 토큰에는 API 액세스 수준이 할당되며, 이 수준에 따라 일일 API 호출 수와 호출할 수 있는 환경이 결정됩니다.
Google API 콘솔 프로젝트: Google API 콘솔 프로젝트는 앱의 OAuth 2.0 사용자 인증 정보를 생성하는 데 사용됩니다. 그러면 앱에서 이러한 사용자 인증 정보를 사용하여 사용자를 인증하고 Google Ads 계정을 관리할 사용자 승인을 획득합니다. 이 승인은 나중에 앱에서 Google Ads 계정에 API 호출을 하는 데 사용됩니다. 프로젝트는 호출을 수락하도록 API도 사용 설정합니다.
Google Ads 고객 계정: API 호출을 실행하는 계정입니다. 보고서를 가져오거나 캠페인을 변경하는 등 이 계정에서 작업을 수행하려면 필요한 권한이 있어야 합니다.
API 호출을 실행할 계정의 10자리 계정 번호도 필요합니다. 이는 Google Ads 웹 인터페이스에 123-456-7890 형식으로 표시됩니다. 이 계정 번호는 하이픈 없이 1234567890와 같이 Google Ads API 호출에 매개변수로 전달됩니다.
지원 도구 및 클라이언트 라이브러리: 이 도구 모음을 사용하면 API와 더 빠르게 통합할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe Google Ads API is designed for managing large or complex Google Ads accounts programmatically, enabling tasks like automated account management, custom reporting, and inventory-based ad management.\u003c/p\u003e\n"],["\u003cp\u003eGoogle offers alternative solutions like Google Ads scripts, BigQuery Data Transfer service, automated rules, bulk uploads, and Google Ads Editor depending on user technical expertise and needs.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Google Ads API, you'll need a Google Ads manager account, a developer token, a Google API Console project, and access to a Google Ads client account with necessary permissions.\u003c/p\u003e\n"],["\u003cp\u003eBefore making API calls, ensure you have the required details, including the 10-digit Google Ads client account number (without hyphens) and support tools or client libraries.\u003c/p\u003e\n"]]],[],null,["# Introduction\n\nThe Google Ads API is used for managing large or complex Google Ads accounts and\ncampaigns. You can build software that manages accounts from the customer level\ndown to the keyword level. Some typical use cases include:\n\n- Automated account management\n- Custom reporting\n- Ad management based on inventory\n- Manage smart bidding strategies\n\nIs the Google Ads API the right product for me?\n-----------------------------------------------\n\nGoogle provides multiple products to help automate Google Ads accounts. Here are\nsome common scenarios and the list of Google products that might best\nfit your needs.\n\n| Scenario | Recommendation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| I am a developer who wishes to build my own software product, or integrate with Google Ads API. I am comfortable writing code, managing software infrastructure including servers and database. | Use the Google Ads API. |\n| I am a developer who is comfortable writing code, but prefer not to manage my own software infrastructure. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am not a developer, but am willing to invest some time learning programming to automate Google Ads. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am a data analyst (or similar role) who wants to download Google Ads reports for further analysis. | Use [BigQuery Data Transfer service](//cloud.google.com/bigquery/docs/dts-introduction). Support is available for [Google Ads transfers](//cloud.google.com/bigquery/docs/google-ads-transfer). |\n| I want to manage Google Ads in bulk, but don't want to write any code. | Use [automated rules](//support.google.com/google-ads/answer/2472779), [bulk uploads](//support.google.com/google-ads/answer/10702932), or [Google Ads Editor](//support.google.com/google-ads/editor/answer/2484521). |\n\nPrerequisites\n-------------\n\nTo make a Google Ads API call, you should have the following details. The rest of this\ntutorial teaches you how to obtain each of these items.\n\n- [**Google Ads manager account**](//support.google.com/google-ads/answer/7459399): You need a Google Ads manager account to apply for the Google Ads API.\n- [**Developer token**](/google-ads/api/docs/get-started/dev-token): This token lets your app connect to the\n Google Ads API. Each developer token is assigned an API access level which\n controls the number of API calls you can make per day with as well as the\n environment to which you can make calls.\n\n- [**Google API Console project**](/google-ads/api/docs/get-started/oauth-cloud-project): The Google API Console project is used\n for generating OAuth 2.0 credentials for your app. The app will then use\n these credentials to authenticate the user and obtain user authorization to\n manage their Google Ads accounts. This authorization is later used by your app\n to make API calls to the Google Ads account. The project also enables the API\n to accept calls.\n\n- [**Google Ads client account**](/google-ads/api/docs/get-started/select-account): This is the account you're making API\n calls against. You need necessary permissions to operate on this account,\n such as fetching reports or making changes to campaigns.\n\n You also need the 10-digit account number of the account you're making API\n calls to. This is displayed in the Google Ads web interface in the form\n `123-456-7890`. This account number is passed as a parameter to the Google Ads API\n call without the hyphens: `1234567890`.\n- [**Support tools and client libraries**](/google-ads/api/docs/get-started/download-tools-libraries): This set of tools can help\n you integrate with the API more quickly."]]
