알림

Duet AI가 Google Workspace를 위한 Gemini로 바뀌었습니다. 자세히 알아보기

서드 파티 앱 일괄 추가 및 구성하기

관리자는 쉼표로 구분된 값(CSV) 파일을 사용하여 여러 서드 파티 앱을 추가하고 구성할 수 있습니다. Google 관리 콘솔에서 빈 CSV 템플릿을 다운로드하거나 관리 콘솔에 있는 모든 서드 파티 앱이 포함된 CSV 파일을 다운로드하여 수정하거나 추가할 수 있습니다.

시작하기 전에

  • CSV 파일의 최대 크기는 10MB입니다.
  • 파일을 업로드하면 유형, ID, 액세스, 조직 단위 열의 정보가 관리 콘솔의 기존 정보를 대체합니다.
  • 정보를 변경하고 싶지 않은 경우 열을 삭제하거나 정보를 그대로 남겨 두거나 해당 정보를 삭제할 수 있습니다.
  • 열에서 모든 정보를 삭제했지만 CSV 파일에 해당 열을 남겨두는 경우, 파일을 업로드할 때 기존 정보가 삭제되지 않습니다.
  • 특정 앱을 수정하지 않으려면 스프레드시트에 행을 남겨두거나 삭제하면 됩니다. 파일에서 앱을 삭제해도 해당 앱은 삭제되지 않습니다.

모두 펼치기  |  모두 접기

CSV 파일에서 앱 추가 및 구성하기

1단계: CSV 파일 다운로드하기
  1. Google 관리 콘솔로그인하세요.

    @gmail.com으로 끝나지 않는 최고 관리자 권한이 있는 계정을 사용하여 로그인하세요.

  2. 관리 콘솔에서 메뉴 그런 다음 보안그런 다음액세스 및 데이터 관리그런 다음API 관리그런 다음서드 파티 앱 액세스 관리로 이동합니다.
    이 작업을 수행하려면 최고 관리자로 로그인해야 합니다.

  3. (선택사항) Google 데이터에 액세스한 앱만 구성하려면 액세스한 앱에서 목록 보기를 클릭합니다. 
  4. 목록 일괄 업데이트를 클릭하고 다음 옵션 중 하나를 선택합니다. 
    • 빈 CSV 템플릿을 다운로드하려면 빈 템플릿 다운로드를 클릭합니다.
    • 관리 콘솔에 이미 표시된 서드 파티 앱을 포함하는 CSV 파일을 다운로드하려면 구성된 앱 다운로드 또는 액세스한 앱 다운로드를 클릭합니다. 다운로드가 완료되면 CSV 다운로드를 클릭합니다. 먼저 작업 을 클릭해야 할 수도 있습니다.
  5. Google Sheets 또는 Microsoft Excel과 같은 스프레드시트 애플리케이션에서 CSV 파일을 엽니다.
    이 파일에는 구성된 각 앱의 속성에 해당하는 열이 포함됩니다. 
2단계: 앱 정보 입력 및 파일 저장하기
  1. 스프레드시트에 있는 열에 다음과 같이 구성하려는 각 앱의 정보를 입력합니다.
    • (선택사항) 앱 이름: 앱 이름을 입력합니다. CSV 파일에서 앱 이름을 변경해도 관리 콘솔에서 업데이트되지 않습니다. 
    • 유형: Android, iOS 또는 웹 애플리케이션을 입력합니다.
    • ID: 웹 앱의 경우 애플리케이션에 발급된 OAuth 클라이언트 ID를 입력합니다. Android 및 iOS 앱의 경우 OAuth 클라이언트 ID, 또는 Google Play나 Apple App Store에서 앱이 사용하는 패키지 또는 번들 ID를 입력합니다. 
    • 액세스: 신뢰할 수 있음, 차단됨, 제한됨, 구성되지 않음(조직 단위 열에 지정된 조직 단위에서 앱을 구성하지 않음) 중 하나를 입력합니다.
    • 조직 단위: 슬래시('/')를 입력하여 앱 액세스 설정을 전체 도메인에 적용합니다. 특정 조직 단위에 액세스 설정을 적용하려면 각 조직 단위의 스프레드시트에 행을 하나 추가하고 앱 이름, 유형, ID를 다시 입력합니다. 원하는 액세스 설정을 입력하고 조직 단위에 전체 경로와 이름(예: '/org_unit_1/sub_unit_1')을 입력합니다.
  2. 스프레드시트를 작성한 후 CSV(.csv) 파일로 저장합니다.
3단계: 파일 업로드하기
  1. 관리 콘솔에서 CSV 파일 첨부를 클릭합니다. 먼저 목록 일괄 업데이트를 클릭해야 할 수 있습니다.
  2. CSV 파일을 찾아서 첨부합니다.
  3. 업로드를 클릭합니다.

업로드 진행 상황을 검토할 수 있습니다. 업로드가 완료되면 이메일 보고서가 전송됩니다.

오류가 있는 경우 불완전한 정보를 입력하고 파일을 다시 업로드합니다. 처리 오류가 발생한 경우 작업 목록에서 로그 파일을 다운로드합니다. 자세한 내용은 이 페이지 아래의 오류 해결하기를 참고하세요.

오류 해결하기

CSV 파일 업로드 시 오류
오류 원인 및 해결 방법
빈 파일입니다. 파일에 포함된 정보가 없습니다. 
잘못된 파일 형식 또는 잘못된 열(열 이름)이 있습니다. 파일에 포함된 열은 앱 이름, 유형, ID, 인증 상태, 사용자, 요청한 서비스, 액세스, 범위가 있는 요청한 서비스, 조직 단위여야 합니다. 
열 이름 열이 누락되었습니다. 필수 열이 누락되었습니다. 유형, ID, 액세스, 조직 단위 열은 필수 항목입니다. 
nn행: 열 이름 열이 비어 있습니다. 특정 행에 필수 정보를 기입해야 하는 열이 비어 있습니다. 예를 들어 앱의 액세스 수준을 입력하지 않으면 2행: "액세스" 열이 비어 있습니다라는 오류가 표시됩니다. 정보를 추가하고 다시 시도하세요.
파일 크기가 10MB 이하여야 합니다. CSV 파일이 10MB를 초과합니다. 파일을 열고 표를 여러 개로 분할하여 각각 CSV 파일로 저장하세요. 모든 CSV 파일에 열 제목 행이 포함되어 있는지 확인합니다.
nn행: 열의 수가 잘못되었습니다.  열의 수가 행의 헤더 열 수와 일치하지 않습니다. 행 세부정보를 확인한 후 다시 시도하세요. 
파일을 읽을 수 없습니다. 확인 후 다시 시도해 주세요. 파일을 읽는 중에 오류가 발생했습니다. 파일을 확인하고 다시 시도하세요.
헤더를 읽을 수 없습니다. 확인 후 다시 시도해 주세요. 업로드된 CSV 파일에 잘못된 헤더가 있습니다. 파일에 포함된 헤더의 제목은 앱 이름, 유형, ID, 인증 상태, 사용자, 요청한 서비스, 액세스, 범위가 있는 요청한 서비스, 조직 단위여야 합니다. 헤더를 확인하고 다시 시도하세요.
파일에 중복된 열(열 이름)이 있습니다. 업로드된 CSV 파일에 중복된 열이 있습니다. 중복 열을 삭제하고 다시 시도하세요.
잘못된 파일 형식입니다. CSV 파일만 업로드하세요. 업로드한 파일 형식이 CSV 형식이 아닙니다. CSV 파일로 저장하고 다시 시도하세요. 
nn행: 파싱할 수 없습니다. CSV 파일의 행을 파싱할 수 없습니다. 행 세부정보를 확인한 후 다시 시도하세요.
nn행: 앱 유형이 잘못되었습니다. 파일의 행에 잘못된 앱 유형이 있습니다. 허용되는 앱 유형은 Android, iOS 또는 웹 애플리케이션입니다.
nn행: 상태가 잘못되었습니다. 파일의 행에 액세스에 대한 잘못된 정보가 있습니다. 액세스 열 값은 '신뢰할 수 있음', '차단됨' 또는 '제한됨'이어야 합니다. 열을 업데이트하고 다시 시도하세요.
nn행: 중복된 항목이 있습니다. 행이 중복되었습니다. 중복된 행을 삭제하고 다시 시도하세요.
nn행: 알 수 없는 오류가 발생했습니다. 행을 파싱하는 중에 알 수 없는 오류가 발생했습니다. 행 세부정보를 확인한 후 다시 시도하세요. 
로그 파일의 오류
오류 원인 및 해결 방법
ACTION FAILED: Validation(작업 실패: 확인) 항목에 지원되지 않는 문자가 포함되어 있습니다. 파일을 확인하고 다시 시도하세요.
ACTION FAILED: UNKNOWN ERROR(작업 실패: 알 수 없는 오류) 일시적인 오류가 발생했습니다. CSV 파일을 다시 업로드하거나 항목을 여러 개로 작게 나누어 업로드해 보세요. 
INVALID_APP_IDENTIFIER(잘못된 앱 ID)

입력한 앱 ID 중 하나 이상이 잘못되었습니다.

  • 웹 앱의 경우 애플리케이션에 발급된 OAuth 클라이언트 ID를 입력합니다. 
  • Android 및 iOS 앱의 경우 OAuth 클라이언트 ID 또는 Google Play나 App Store에서 앱이 사용하는 패키지 또는 번들 ID를 입력합니다.
INVALID_ORG_UNIT_PATH(잘못된 조직 단위 경로) 입력한 조직 단위가 올바르지 않습니다. 조직 단위를 변경하고 다시 시도하세요.
CONFIGURATION_LIMIT_REACHED(구성 한도에 도달함) 구성된 앱 수 한도인 15,000개에 도달했거나 이를 초과했습니다. 일괄 또는 개별적으로 구성할 수 있는 서드 파티 앱의 총개수는 15,000개입니다. 추가 행을 삭제하고 다시 시도하세요. 
FIRST_PARTY_APP_ERROR(퍼스트 파티 앱 오류) 앱 ID가 서드 파티 앱에 속하지 않으므로 구성할 수 없습니다. 파일에서 앱을 삭제하고 다시 시도하세요.


Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?
검색
검색어 지우기
검색 닫기
Google 앱
기본 메뉴
10000741412326497277
true
도움말 센터 검색
true
true
true
true
true
73010