2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은 지원 중단 페이지를 참고하세요.
Display & Video 360 API를 사용할 때 오류가 발생할 수 있는 시나리오는 다양합니다. 이러한 오류는 코드의 버그, 잘못된 사용자 입력 또는 API 자체의 문제와 관련이 있을 수 있습니다. 이유가 무엇이든 오류를 해결하는 방법을 아는 것은 개발 프로세스에서 중요한 부분입니다. 이 가이드에서는 시작하는 데 도움이 되는 몇 가지 권장사항을 제공합니다.
기본사항 검토
기본 요건 가이드를 검토합니다. Display & Video 360 및 올바르게 구성된 API 프로젝트에 액세스할 수 있는지 확인합니다.
응답에 HTTP 오류가 포함된 경우 이를 신중하게 검토하고 올바른 API 및 서비스에 요청이 이루어지고 있는지 확인합니다.
승인 가이드를 검토합니다. 요청에 필요한 OAuth 2.0 사용자 인증 정보가 포함되어 있는지 확인합니다.
일반적인 오류 섹션에 해당 오류가 포함되어 있지 않으면 참조 문서를 참고하여 오류 코드, 상태, 메시지를 검색해 보세요.
문서화되지 않은 오류가 발견되면 알려주세요.
근본 원인 파악
이제 오류를 파악하고 그 의미를 이해했습니다. 그렇지 않은 경우 오류 이해하기로 돌아가거나 직접 해결할 수 없는 API 오류가 발생했다고 생각되면 도움말 확인으로 이동하세요.
오류를 수정하려면 먼저 오류의 원인을 파악해야 합니다. 이는 코드의 버그나 잘못된 입력 값인 경우가 많습니다.
문제가 코드의 버그와 관련이 있는지 확인하려면 먼저 코드가 의도한 대로 작동하는지 확인해야 합니다. 첫 번째 단계로, 실패하는 요청을 실행하는 코드 섹션을 검토하여 명백한 문제를 확인해 보세요. 경우에 따라 디버깅 도구를 사용하여 코드를 한 줄씩 단계별로 살펴보고 올바르게 작동하는지 확인해야 할 수 있습니다.
HTTP 요청을 검사하는 것도 잠재적인 버그와 잘못된 입력 사례를 식별하는 데 유용한 방법입니다. 많은 공식 클라이언트 라이브러리를 HTTP 요청 및 응답을 로깅하도록 구성할 수 있습니다. 자세한 내용은 사용 중인 라이브러리의 문서를 참고하세요. Charles, Squid, Fiddler와 같은 HTTP 프록시를 사용하여 요청 및 응답 로그를 캡처할 수도 있습니다. 이러한 로그를 가져온 후 로그를 검토하여 애플리케이션에서 제공하는 요청 매개변수 값이 올바르고 예상과 일치하는지 확인합니다.
오류를 일으킨 버그 또는 잘못된 입력을 파악하면 해결 방법이 명확해질 것입니다. 문제가 해결되지 않거나 문제를 해결하는 가장 좋은 방법을 잘 모르겠다면 지금까지 수집한 정보를 사용하여 도움을 받을 수 있습니다.
도움 받기
오류를 직접 해결할 수 없는 경우 Display & Video 360 고객센터에 있는 이 양식을 통해 지원팀에 문의할 수 있습니다.
이 양식을 작성할 때는 발생한 문제와 이미 취한 문제 해결 단계에 관한 정보를 최대한 많이 포함해야 합니다. 포함할 유용한 정보:
HTTP 요청 및 응답 로그 OAuth 2.0 액세스 토큰, 이메일 주소와 같은 민감한 정보는 삭제해야 합니다.
코드 스니펫 문제를 코드의 특정 섹션으로 분리할 수 있거나 문제가 언어별 문제라고 생각되면 수행 중인 작업을 보여주는 작은 스니펫을 포함하세요.
문제를 재현하려는 다른 사용자에게 유용할 수 있는 추가 정보(예: 런타임/인터프리터 버전 및 플랫폼)
문제 해결
문제의 원인을 파악하고 해결 방법을 찾았다면 이제 수정사항을 구현할 차례입니다. 가능하면 프로덕션에 배포하기 전에 제어된 환경 (예: 테스트용으로 구성된 파트너 또는 광고주)에서 다양한 유효한 입력과 잘못된 입력에 대해 수정사항을 테스트합니다.
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis guide provides best practice tips for troubleshooting errors encountered when working with the Display & Video 360 API, covering common causes like bugs, invalid input, or API issues.\u003c/p\u003e\n"],["\u003cp\u003eWhen an error occurs, the API typically returns a JSON response with an \u003ccode\u003eerror\u003c/code\u003e object containing details about the issue; if not, review basic setup steps.\u003c/p\u003e\n"],["\u003cp\u003eIf the error isn't readily understood, consult the common errors section, reference documentation, or the Display & Video 360 help center for field validation and limits.\u003c/p\u003e\n"],["\u003cp\u003eTo identify the root cause, examine your code, validate input values using HTTP request logs, and use debugging tools to pinpoint the source of the problem.\u003c/p\u003e\n"],["\u003cp\u003eIf you're unable to resolve the error, contact the support team with detailed information about the issue, troubleshooting steps taken, and relevant code snippets.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting\n\nThere are many scenarios where you may encounter errors when working with the\nDisplay \\& Video 360 API. These could relate to a bug in your code, invalid user input,\nor even an issue with the API itself. Whatever the reason, knowing how to\ntroubleshoot errors is an important part of the development process. This guide\nwill provide some best practice tips to get you started.\n\nReviewing the basics\n--------------------\n\n1. Review the [prequisites guide](/display-video/api/guides/getting-started/overview#prerequisites). Ensure you have access to Display \\& Video 360 and a properly configured API project.\n2. If your response contains HTTP errors, make sure you review these carefully and ensure that the request is being made to the correct API and service.\n3. Review the [authorization guide](/display-video/api/guides/how-tos/authorizing). Ensure your request contains the necessary OAuth 2.0 credentials.\n4. Verify that you're using the correct credentials. See the\n [Set Up Your Application guide](/display-video/api/guides/getting-started/configure) for details on generating\n authentication credentials. You may also pass your access token to the\n [Google OAuth2 API's tokeninfo endpoint](//developers.google.com/apis-explorer/#p/oauth2/v2/oauth2.tokeninfo) to verify that it is\n issued to the correct API project and authorized for the correct scope(s):\n\n POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}\n\n 200 OK\n\n {\n \"issued_to\": \"{API_PROJECT_CLIENT_ID}\",\n \"audience\": \"...\",\n \"scope\": \"{API_SCOPES}\",\n \"expires_in\": ...\n }\n\nUnderstanding errors\n--------------------\n\nWhen the API encounters an error, it normally returns a JSON response containing\nan `error` object. This object provides additional context about the specific\nerror that was encountered. \n\n {\n \"error\": {\n \"code\": 404,\n \"message\": \"Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1\",\n \"status\": \"NOT_FOUND\"\n }\n }\n\n| **Note:** If you receive an error response that does not include an `error` object, there's a chance the error is not coming from the Display \\& Video 360 API. Please refer back to the section on [reviewing the basics](#basics) before continuing.\n\nUsually the contents of the `error` object will contain enough information to\nhelp you identify what's gone wrong. If not, you may need to do some additional\nresearch to figure out what the error means.\n\n### Researching errors\n\n1. Refer to the section on [common errors](/display-video/api/guides/best-practices/errors), which provides\n details for some of the most frequently encountered errors.\n\n2. If the error isn't covered in the common errors section, refer to the\n [reference documentation](/display-video/api/reference/rest) and try searching for the error code,\n status, and message.\n\n3. If you come across any errors that aren't documented, please let us know.\n\n| **Key Point:** If the error you've encountered relates to field validation or a partner/advertiser limit, review the [Display \\& Video 360 help center](//support.google.com/displayvideo) for more information. These rules and limits are inherited from Display \\& Video 360 and are not enforced by the Display \\& Video 360 API itself.\n\nIdentifying the root cause\n--------------------------\n\nBy this point you've identified the error and understand what it means. If not,\nhead back to [understanding errors](#understand) or jump ahead to\n[getting help](#get-help) if you believe you've come across an error in the API\nthat you can't fix yourself.\n\nBefore you can fix the error, you'll need to identify what's causing it. Often\nthis will be a bug in your code or an invalid input value.\n\nTo determine whether the issue is related to a bug in your code, you\nshould first verify that your code is working as intended. As a first step,\nconsider reviewing the section of code responsible for making the failing\nrequest to check for obvious issues. In some cases it may be necessary to use a\ndebugging tool to step through the code line-by-line to ensure it's functioning\ncorrectly.\n\nExamining HTTP requests is another useful way to identify potential bugs, as\nwell as cases of invalid input. Many of the official client libraries can be\nconfigured to log HTTP requests and responses; review the documentation for your\nlibrary of choice for more details. An HTTP proxy such as\n[Charles](//www.charlesproxy.com/), [Squid](//www.squid-cache.org/), or [Fiddler](//www.telerik.com/fiddler)\ncan also be used to capture request and response logs. Once you obtain these\nlogs, review them to ensure that the request parameter values being provided by\nyour application are correct and match what you expect.\n\nOnce you identify the bug or invalid input responsible for causing the error,\nthe fix will hopefully be obvious. If you're stuck or unsure how best to fix the\nproblem, however, you can use the information you've gathered so far when\ngetting help.\n\n### Getting help\n\nIf you aren't able to resolve an error yourself, you can contact our support\nteam via this [form](/display-video/api/support/contact) located in the Display \\& Video 360 help center.\n\nWhen filling out this form, you should include as much information as possible\nabout the issue you're facing and the troubleshooting steps you've already\ntaken. Useful information to include:\n\n- HTTP request and response logs. Make sure to redact sensitive information such as OAuth 2.0 access tokens, email addresses, etc.\n- Code snippet. If you're able to isolate the issue to a particular section of code or suspect the issue is language-specific, include a small snippet to illustrate what you're doing.\n- Additional information, such as runtime/interpreter version and platform, which may be useful for others attempting to reproduce the issue.\n\nFixing the issue\n----------------\n\nOnce you've identified the cause of the issue and come up with a solution, it's\ntime to implement a fix. Whenever possible, test your fix in a controlled\nenvironment (such as a partner or advertiser configured specifically for\ntesting) against a range of both good and bad inputs before deploying to\nproduction."]]
