문제 해결

동영상: 2019년 워크숍의 오류 처리 대담을 확인해 보세요.

오류는 잘못된 환경 설정이나 사용자의 소프트웨어 또는 잘못된 입력으로 인해 발생할 수 있습니다. 소스에 상관없이 문제를 해결하고 코드를 수정하거나 확인할 수 있습니다. 이 가이드에서는 문제 해결을 위한 몇 가지 권장사항을 설명합니다. Google Ads API에서 찾을 수 있습니다.

연결 보장

  1. Google Ads API에 액세스할 수 있고 설정이 올바른지 확인하세요. 만약 HTTP 오류가 반환되면 이를 신중하게 해결하고 서비스에 도달하는지 확인해야 합니다.

  2. 사용자 인증 정보는 request를 사용자를 인증합니다 Google Ads API의 구조를 숙지합니다. 특히 이러한 요청을 받지 않고 호출을 처리할 경우 클라이언트 라이브러리 사용 각 클라이언트 라이브러리는 구성 파일에 자격 증명을 포함하는 방법에 대한 지침( 클라이언트 라이브러리의 README 파일을 참조하세요.

  3. 올바른 자격 증명을 사용하고 있는지 확인합니다. Google의 빠른 시작은 확인해 보시기 바랍니다. 예를 들어 다음 응답 실패는 사용자가 잘못된 사용자 인증 정보를 보냈습니다.

    {
  "error": {
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. Visit https://developers.google.com/identity/sign-in/web/devconsole-project.",
    "status": "UNAUTHENTICATED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "Authentication error: 2"
      }
    ]
  }
}

위 단계를 따른 후에도 계속 문제가 발생하면 Google Ads API 오류를 해결할 수 있습니다.

문제 판단

Google Ads API는 일반적으로 다음을 포함하는 JSON 실패 객체로 오류를 보고합니다. 응답의 오류 목록입니다. 이러한 객체는 오류 코드와 문제가 발생한 이유를 설명하는 메일 이 지표는 광고 캠페인이 가능성이 있습니다.

{
  "errors": [
    {
      "errorCode": { "fieldMaskError": "FIELD_NOT_FOUND" },
      "message": "The field mask contained an invalid field: 'keyword/matchtype'.",
      "location": { "operationIndex": "1" }
    }
  ]
}

모든 클라이언트 라이브러리는 응답의 오류를 캡슐화합니다 이러한 예외와 로그나 문제 해결 화면에 메시지를 출력하는 것이 시작합니다. 이 정보를 문제를 발생시킬 수 있는 요소에 대한 유용한 개요를 제공합니다 로그에서 오류를 식별한 후에는 있습니다.

오류 조사

  1. 일반적인 오류를 참조하세요. 문서를 참조하세요. 그것은 은 오류 메시지, 관련 API 참조 및 오류를 처리합니다

  2. 일반 오류 문서에 해당 오류가 구체적으로 언급되어 있지 않은 경우 참조 문서를 확인하고 오류 문자열을 찾습니다.

  3. 지원 채널을 검색하여 API에 대한 자신의 경험을 공유하는 개발자들도 있습니다. 다른 사용자가 직면하고 해결하도록 노력해야 합니다.

  4. 문서화되지 않은 오류가 발생하는 경우 도움이 될 것입니다

  5. Google Ads 고객센터로 이동 확인 또는 계정 한도 문제를 해결하는 데 도움이 필요하면 Google Ads API는 핵심 Google Ads 제품의 규칙과 제한사항을 상속합니다.

  6. 블로그 게시물 은 애플리케이션 문제를 해결할 때 종종 좋은 참고 자료가 됩니다.

오류를 조사한 후 근본 원인을 파악할 차례입니다.

원인 찾기

예외 메시지를 확인하여 오류의 원인을 파악합니다. 확인한 후 요청에서 가능한 원인을 확인합니다. 일부 Google Ads API 오류 메시지에는 fieldPathElements가 포함됩니다. location 필드에 GoogleAdsError: 확인할 수 있습니다 예를 들면 다음과 같습니다.

{
  "errors": [
    {
      "errorCode": {"criterionError": "CANNOT_ADD_CRITERIA_TYPE"},
      "message": "Criteria type can not be targeted.",
      "trigger": { "stringValue": "" },
      "location": {
        "operationIndex": "0",
        "fieldPathElements": [ { "fieldName": "keyword" } ]
      }
    }
  ]
}

문제를 해결할 때 애플리케이션이 API에 전달하는 역할을 합니다 Google은 대화형 기술을 사용할 것을 적극 권장합니다. Google의 무료 플랫폼인 Eclipse와 같은 IDE 오픈 소스 IDE로, 주로 Java 개발에 사용되지만 디버깅에 도움이 될 수 있습니다. 이 기능을 사용하면 코드를 한 줄씩 단계별로 실행합니다.

요청이 애플리케이션 입력과 일치하는지 다시 한번 확인합니다. 예를 들어 캠페인의 이름으로 요청에 포함되지 않을 수 있습니다. 을(를) 전송합니다. 필드 마스크 Google Ads API는 희소 업데이트를 지원합니다. 변경 요청에서 필드 마스크의 필드 누락은 API를 나타냅니다. 그대로 두어야 합니다 애플리케이션이 객체를 검색하고, 변경을 수행하고, 다시 반환하는 경우 있습니다. 참조 문서를 검토하여 필드를 업데이트할 수 있습니다

지원을 받는 방법

항상 혼자서 문제를 식별하고 해결할 수 있는 것은 아닙니다. 포럼에 질문하면 같은 문제를 처리해야 했을 수 있는 수천 명의 개발자에게 있습니다.

검색어에 최대한 많은 정보를 포함하세요. 다음의 항목을 포함할 것을 권장합니다.

  • 정리된 JSON 요청 및 응답 민감한 정보 삭제는 개발자 토큰이나 AuthToken 등의 정보를 제공해야 합니다.
  • 코드 스니펫 언어 관련 문제가 있거나 API 사용과 관련하여 도움을 요청하는 경우, 도움이 되는 코드 스니펫을 설명할 수 있어야 합니다
  • RequestId입니다. 이를 통해 Google 개발자 관계 팀원은 사용자의 요청을 할 수 있습니다. 요청의 속성으로 포함된 requestId를 로그에 등록하는 것이 좋습니다. 응답 오류를 캡슐화하는 예외와 추가 컨텍스트 사용할 수 있습니다.
  • 런타임/인터프리터 버전 및 문제 해결에도 도움이 될 수 있습니다

문제 해결

이제 문제를 파악하고 해결책을 찾았으므로 변경사항을 적용하고 테스트 계정을 대상으로 수정사항을 테스트하기 (권장) 프로덕션 (버그가 특정 프로덕션 계정의 데이터에만 적용되는 경우)

공유 고려

이전에 제기되지 않은 오류에 대해 포럼에 질문을 게시한 경우 솔루션을 발견했다면 이를 보고서에 추가해 보세요. 스레드가 필요합니다. 다음에 개발자가 같은 문제를 겪으면 해결할 수 있을 것입니다. 즉시 사용할 수 있습니다.

다음 단계

이제 이 문제를 해결했으니 어떻게 해야 할까요?

적절한 단위 테스트 세트를 만들면 코드 품질과 신뢰성을 개선하는 데 도움이 됩니다. 크게 향상되었습니다. 또한 새로운 변경사항을 테스트하는 속도도 이전 기능을 중단하지 않았습니다. 좋은 오류 처리 전략은 문제 해결에 필요한 모든 데이터를 표시하는 데 핵심적인 역할을 합니다.

이전
시스템 한도
다음
테스트