이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오류 해결 및 Google Workspace 구독 재활성화하기

이 페이지에서는 오류를 해결하거나 문제 해결하고 subscriptions.reactivate() 메서드를 호출하여 정지된 Google Workspace 구독을 재활성화하는 방법을 설명합니다.

오류로 인해 구독에서 이벤트를 수신하지 못할 때마다 Google Workspace 구독이 정지됩니다. 예를 들어 대상 리소스 또는 알림 엔드포인트를 찾을 수 없는 경우 구독이 정지됩니다. 정기 결제의 오류를 해결한 후 정기 결제를 다시 활성화하여 이벤트 수신을 다시 시작할 수 있습니다.

정지된 정기 결제에 대해 알아보려면 다음 방법을 따르세요.

앱이 정지에 관한 수명 주기 이벤트를 수신합니다. 엔드포인트의 오류로 인해 구독이 정지되면 수명 주기 이벤트가 수신되지 않을 수 있습니다.
subscriptions.get() 또는 subscriptions.list() 메서드를 사용하여 정기 결제의 state 필드가 SUSPENDED로 설정되어 있는지 확인합니다.
알림 엔드포인트의 전송 실패에 관한 알림이 전송됩니다. Google Cloud Pub/Sub 주제의 전송 실패 모니터링에 관해 알아보려면 메시지 실패 처리를 참고하세요.

정기 결제를 재활성화하면 원래 만료일이 유지됩니다. 정기 결제의 만료 시간을 연장하려면 정기 결제 업데이트 또는 갱신을 참고하세요.

Apps Script

Google Workspace 구독 정기 결제를 만들려면 정기 결제 만들기를 참고하세요.
구독의 모든 이벤트 유형을 지원하는 범위 하나 이상를 사용하여 사용자를 인증해야 합니다.

참고: 이 가이드의 코드 샘플을 실행하려면 정기 결제를 만들 때 사용한 것과 동일한 OAuth 클라이언트 ID 사용자 인증 정보를 사용해야 합니다.

Apps Script 프로젝트:
- Apps Script에서 자동으로 생성된 기본 프로젝트 대신 Google Cloud 프로젝트를 사용합니다.
- OAuth 동의 화면을 구성하기 위해 추가한 모든 범위의 경우 Apps Script 프로젝트의 appsscript.json 파일에 범위도 추가해야 합니다. 예를 들면 다음과 같습니다.
- Google Workspace Events 고급 서비스를 사용 설정합니다.

Python

Python 3.6 이상
pip 패키지 관리 도구
Python용 최신 Google 클라이언트 라이브러리입니다. 이를 설치하거나 업데이트하려면 명령줄 인터페이스에서 다음 명령어를 실행합니다.
```
  pip3 install --upgrade google-api-python-client google-auth-oauthlib
  
```

Google Workspace 구독 정기 결제를 만들려면 정기 결제 만들기를 참고하세요.
구독의 모든 이벤트 유형을 지원하는 범위를 하나 이상 사용한 사용자 인증이 필요합니다.

참고: 이 가이드의 코드 샘플을 실행하려면 구독을 만들 때 사용한 것과 동일한 OAuth 클라이언트 ID 사용자 인증 정보를 사용해야 합니다.

오류 식별 및 해결

정기 결제의 오류를 식별하려면 정기 결제의 suspensionReason 필드를 검토합니다. 이 필드는 정지에 관한 수명 주기 이벤트를 수신할 때 또는 subscriptions.get() 메서드를 사용하여 정기 결제의 모든 필드를 검토할 때 확인할 수 있습니다.

다음 표에는 정기 결제에서 발생할 수 있는 오류와 가능한 경우 오류를 해결하는 방법이 나와 있습니다. 오류를 해결할 수 없는 경우 구독을 삭제하거나 구독이 만료될 때까지 기다릴 수 있습니다. Google Workspace Events API는 만료된 구독을 자동으로 삭제합니다.

오류	설명	해결 방법
`USER_SCOPE_REVOKED`	승인 사용자가 구독에 필요한 하나 이상의 OAuth 범위 부여를 취소했습니다.	다른 액세스 토큰을 가져옵니다. 자세한 내용은 Google 승인 서버에서 액세스 토큰 가져오기를 참고하세요.
`RESOURCE_DELETED`	정기 결제의 대상 리소스가 삭제됩니다.	리소스가 복원되면 `reactivate()` 메서드를 호출합니다. 그렇지 않은 경우 원래 대상 리소스 없이 구독을 재활성화할 수 없으므로 별도의 조치가 필요하지 않습니다.
`USER_AUTHORIZATION_FAILURE`	승인한 사용자는 더 이상 정기 결제 리소스에 액세스할 수 없습니다.	별도의 조치는 필요하지 않습니다. 승인한 사용자가 대상 리소스에 액세스할 수 없으므로 정기 결제를 재활성화할 수 없습니다.
`ENDPOINT_PERMISSION_DENIED`	Google Workspace 애플리케이션은 알림 엔드포인트로 이벤트를 전송할 수 있는 액세스 권한이 없습니다.	이벤트를 전송하는 Google Workspace 애플리케이션의 서비스 계정에 대한 액세스 권한을 부여합니다. Google Chat 이벤트의 경우 서비스 계정은 `chat-api-push@system.gserviceaccount.com`입니다. Google Meet 이벤트의 경우 서비스 계정은 `meet-api-event-push@system.gserviceaccount.com`입니다. Pub/Sub 주제의 경우 Pub/Sub 게시자 역할 (`roles/pubsub.publisher)`)을 서비스 계정에 부여합니다.
`ENDPOINT_NOT_FOUND`	알림 엔드포인트가 존재하지 않거나 찾을 수 없습니다.	엔드포인트가 아직 활성 상태이고 작동하는지 확인합니다. Pub/Sub 주제 문제를 해결하려면 문제 해결 문서를 참고하세요.
`ENDPOINT_RESOURCE_EXHAUSTED`	할당량이 부족하거나 비율 제한에 도달하여 알림 엔드포인트에서 이벤트를 수신하지 못했습니다.	할당량 상향 조정을 요청합니다.

구독 재활성화

정기 결제를 정지한 오류를 해결한 후 reactivate() 메서드를 사용하여 정기 결제가 이벤트를 다시 수신하도록 할 수 있습니다. 이 메서드는 모든 오류가 해결되었는지 확인하고 정기 결제의 state 필드를 SUSPENDED에서 ACTIVE로 변경합니다.

Google Workspace 구독을 재활성화하려면 다음 단계를 따르세요.

Apps Script

Apps Script 프로젝트에서 reactivateSubscription라는 새 스크립트 파일을 만들고 다음 코드를 추가합니다.
```
function reactivateSubscription() {
  // The name of the subscription to reactivate.
  const name = 'subscriptions/SUBSCRIPTION_ID';

  // Call the Workspace Events API using the advanced service.
  const response = WorkspaceEvents.Subscriptions.reactivate({}, name);
  console.log(response);
}
```
다음을 바꿉니다.
- SUBSCRIPTION_ID: 구독 ID입니다. ID를 가져오려면 다음 중 하나를 사용하면 됩니다.
  - uid 필드의 값입니다.
  - name 필드에 표시된 리소스 이름의 ID입니다. 예를 들어 리소스 이름이 subscriptions/subscription-123이면 subscription-123을 사용합니다.
Google Workspace 구독을 재활성화하려면 Apps Script 프로젝트에서 reactivateSubscription 함수를 실행합니다.

Python

작업 디렉터리에 reactivate_subscription.py이라는 파일을 만들고 다음 코드를 추가합니다.
```
"""Reactivate subscription."""

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [SCOPES]

# Authenticate with Google Workspace and get user authentication.
flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
CREDENTIALS = flow.run_local_server()

# Call the Workspace Events API using the service endpoint.
service = build(
    'workspaceevents',
    'v1',
    credentials=CREDENTIALS,
)

NAME = 'subscriptions/SUBSCRIPTION_ID'
response = service.subscriptions().reactivate(name=NAME).execute()
print(response)
```
다음을 바꿉니다.
- SCOPES: 구독의 각 이벤트 유형을 지원하는 OAuth 범위 1개 이상 문자열 배열 형식입니다. 여러 범위를 나열하려면 쉼표로 구분합니다. 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'를 예로 들 수 있습니다.
- SUBSCRIPTION_ID: 구독 ID입니다. ID를 확인하려면 다음 중 하나를 사용하면 됩니다.
  - uid 필드의 값입니다.
  - name 필드에 표시되는 리소스 이름의 ID입니다. 예를 들어 리소스 이름이 subscriptions/subscription-123이면 subscription-123을 사용합니다.
작업 디렉터리에서 OAuth 클라이언트 ID 사용자 인증 정보를 저장하고 파일 이름을 client_secrets.json로 지정했는지 확인합니다. 이 코드 샘플은 이 JSON 파일을 사용하여 Google Workspace에 인증하고 사용자 사용자 인증 정보를 가져옵니다. 자세한 내용은 OAuth 클라이언트 ID 사용자 인증 정보 만들기를 참고하세요.
Google Workspace 구독을 재활성화하려면 터미널에서 다음을 실행합니다.
```
python3 reactivate_subscription.py
```

Google Workspace Events API는 Subscription 리소스의 인스턴스를 포함하는 장기 실행 작업을 반환합니다.

요청이 실패하면 다음 섹션에서 추가 오류를 해결하세요.

여러 오류 문제 해결하기

정기 결제를 정지한 오류를 해결했는데 reactivate() 메서드가 실패하면 정기 결제가 정지된 후에 다른 오류가 발생했을 수 있습니다.

추가 오류를 식별하려면 실패한 요청의 출력을 검토하세요. 출력에는 여전히 존재하는 오류가 포함됩니다.

정기 결제에 오류가 여러 개 있는 경우 suspensionReason 필드의 값은 항상 정기 결제를 정지한 원래 오류를 사용합니다.

오류 해결 및 Google Workspace 구독 재활성화하기

Apps Script

Python

오류 식별 및 해결

구독 재활성화

Apps Script

Python

여러 오류 문제 해결하기

관련 주제