관리자는 쉼표로 구분된 값(CSV) 파일을 사용하여 여러 서드 파티 앱을 추가하고 구성할 수 있습니다. Google 관리 콘솔에서 빈 CSV 템플릿을 다운로드하거나 관리 콘솔에 있는 모든 서드 파티 앱이 포함된 CSV 파일을 다운로드하여 수정하거나 추가할 수 있습니다.
시작하기 전에
- CSV 파일의 최대 크기는 10MB입니다.
- 파일을 업로드하면 유형, ID, 액세스, 조직 단위 열의 정보가 관리 콘솔의 기존 정보를 대체합니다.
- 정보를 변경하고 싶지 않은 경우 열을 삭제하거나 정보를 그대로 남겨 두거나 해당 정보를 삭제할 수 있습니다.
- 열에서 모든 정보를 삭제했지만 CSV 파일에 해당 열을 남겨두는 경우, 파일을 업로드할 때 기존 정보가 삭제되지 않습니다.
- 특정 앱을 수정하지 않으려면 스프레드시트에 행을 남겨두거나 삭제하면 됩니다. 파일에서 앱을 삭제해도 해당 앱은 삭제되지 않습니다.
CSV 파일에서 앱 추가 및 구성하기
1단계: CSV 파일 다운로드하기
-
-
관리 콘솔에서 메뉴
보안
액세스 및 데이터 관리
이 작업을 수행하려면 최고 관리자로 로그인해야 합니다. - (선택사항) Google 데이터에 액세스한 앱만 구성하려면 액세스한 앱에서 목록 보기를 클릭합니다.
- 목록 일괄 업데이트를 클릭하고 다음 옵션 중 하나를 선택합니다.
- 빈 CSV 템플릿을 다운로드하려면 빈 템플릿 다운로드를 클릭합니다.
- 관리 콘솔에 이미 표시된 서드 파티 앱을 포함하는 CSV 파일을 다운로드하려면 구성된 앱 다운로드 또는 액세스한 앱 다운로드를 클릭합니다. 다운로드가 완료되면 CSV 다운로드를 클릭합니다. 먼저 작업
을 클릭해야 할 수도 있습니다.
- Google Sheets 또는 Microsoft Excel과 같은 스프레드시트 애플리케이션에서 CSV 파일을 엽니다.
이 파일에는 구성된 각 앱의 속성에 해당하는 열이 포함됩니다.
2단계: 앱 정보 입력 및 파일 저장하기
- 스프레드시트에 있는 열에 다음과 같이 구성하려는 각 앱의 정보를 입력합니다.
- (선택사항) 앱 이름: 앱 이름을 입력합니다. CSV 파일에서 앱 이름을 변경해도 관리 콘솔에서 업데이트되지 않습니다.
- 유형: Android, iOS 또는 웹 애플리케이션을 입력합니다.
- ID: 웹 앱의 경우 애플리케이션에 발급된 OAuth 클라이언트 ID를 입력합니다. Android 및 iOS 앱의 경우 OAuth 클라이언트 ID, 또는 Google Play나 Apple App Store에서 앱이 사용하는 패키지 또는 번들 ID를 입력합니다.
- 액세스: 신뢰할 수 있음, 차단됨, 제한됨, 구성되지 않음(조직 단위 열에 지정된 조직 단위에서 앱을 구성하지 않음) 중 하나를 입력합니다.
- 조직 단위: 슬래시('/')를 입력하여 앱 액세스 설정을 전체 도메인에 적용합니다. 특정 조직 단위에 액세스 설정을 적용하려면 각 조직 단위의 스프레드시트에 행을 하나 추가하고 앱 이름, 유형, ID를 다시 입력합니다. 원하는 액세스 설정을 입력하고 조직 단위에 전체 경로와 이름(예: '/org_unit_1/sub_unit_1')을 입력합니다.
- 스프레드시트를 작성한 후 CSV(.csv) 파일로 저장합니다.
3단계: 파일 업로드하기
- 관리 콘솔에서 CSV 파일 첨부를 클릭합니다. 먼저 목록 일괄 업데이트를 클릭해야 할 수 있습니다.
- CSV 파일을 찾아서 첨부합니다.
- 업로드를 클릭합니다.
업로드 진행 상황을 검토할 수 있습니다. 업로드가 완료되면 이메일 보고서가 전송됩니다.
오류가 있는 경우 불완전한 정보를 입력하고 파일을 다시 업로드합니다. 처리 오류가 발생한 경우 작업 목록에서 로그 파일을 다운로드합니다. 자세한 내용은 이 페이지 아래의 오류 해결하기를 참고하세요.
오류 해결하기
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 중 하나 이상이 잘못되었습니다.
|
| INVALID_ORG_UNIT_PATH(잘못된 조직 단위 경로) | 입력한 조직 단위가 올바르지 않습니다. 조직 단위를 변경하고 다시 시도하세요. |
| CONFIGURATION_LIMIT_REACHED(구성 한도에 도달함) | 구성된 앱 수 한도인 15,000개에 도달했거나 이를 초과했습니다. 일괄 또는 개별적으로 구성할 수 있는 서드 파티 앱의 총개수는 15,000개입니다. 추가 행을 삭제하고 다시 시도하세요. |
| FIRST_PARTY_APP_ERROR(퍼스트 파티 앱 오류) | 앱 ID가 서드 파티 앱에 속하지 않으므로 구성할 수 없습니다. 파일에서 앱을 삭제하고 다시 시도하세요. |
Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.
