작업을 사용자에게 출시하기 전에 철저히 테스트하고, 대상 표시 경로, 위치, 기기를 지정하며, 작업이 Google의 작업 정책을 준수하는지 확인해야 합니다. 이 페이지에서는 검토를 위해 작업을 제출하기 위해 준비하고 베타 또는 프로덕션 채널에 출시하기 위한 승인을 얻기 위해 실행해야 하는 작업을 간략하게 설명합니다.
정책 위반 여부 확인
작업이 Actions on Google 정책을 준수하는지 확인합니다. 일반적으로 콘텐츠는 다음 가이드라인을 따르세요.
- 구체적으로 지정: 사용자가 작업을 구체적으로 호출할 수 있어야 합니다. 표시 이름이나 발음을 선택할 때 너무 광범위하거나 일반적인 표현은 하지 마세요. 예를 들어 작업 구문으로 "[도시] 날씨 확인" 대신 "WeatherApp에 문의하여 [도시] 날씨 확인"을 사용하세요. 적절한 작업 문구를 제공하기 위한 가이드라인을 따르세요.
- 금지된 콘텐츠 피하기: 과학, 예술, 다큐멘터리 또는 교육적 목적으로 사용되는 경우가 아니라면, 노골적인 성적, 폭력, 불법 또는 증오성 콘텐츠가 포함된 작업은 Actions on Google 정책에 위배됩니다. 폭력이나 괴롭힘을 조장하는 행위도 거부되거나 중단됩니다.
- 저작권 및 지식 재산 존중: 작업에서 제공하는 콘텐츠를 사용할 적절한 권리를 보유해야 합니다.
- 정직함: 거짓 주장으로 사용자를 오도하거나 기만해서는 안 됩니다.
- 사용자의 개인 정보 보호 및 보안: 사용자 데이터를 처리하고, 사용자 데이터를 안전하게 전송하고, 개인정보처리방침을 제공하는 방법을 투명하게 공개합니다.
- 요청 없이 사용자의 말을 듣지 않음: 작업이 언제 사용자의 입력을 기다리는지 알아야 합니다. 사용자에게 메시지를 표시하지 않고 마이크를 켜진 상태로 유지하는 것은 YouTube 정책에 설명된 일반적인 실수입니다. 작업이 거부될 위험을 줄이기 위해 명령어를 대기할 때 작업이 사용자에게 알려야 합니다.
- 호출 및 표시 이름 검토: 호출 이름이 어시스턴트 디렉터리 페이지에 표시되는 표시 이름과 일치하는지 확인하세요. 두 이름 모두 사용자가 작업을 쉽게 호출할 수 있을 만큼 구체적이어야 합니다. 호출 및 표시 이름은 Actions on Google 정책도 준수해야 합니다.
신속한 작업 검토 및 승인을 위해 전체 정책 목록을 확인하고 정책을 준수하는지 확인하세요.
표시 이름 설정
표시 이름은 사용자가 작업을 명시적으로 호출하는 방법을 정의합니다. 이 이름은 어시스턴트 디렉터리에서도 사용됩니다.
표시 이름을 설정하려면 다음 단계를 따르세요.
- 개발 > 호출 > 설정으로 이동합니다.
- 작업의 표시 이름을 입력합니다.
- 재생 play_circle_filled 아이콘을 클릭하면 이름이 어떻게 발음되는지 들을 수 있습니다.
표시 이름 변경
작업의 표시 이름은 언제든지 변경할 수 있습니다. 그러나 사용자가 새 이름을 사용하여 작업을 호출하기 전에 작업이 전체 검토 프로세스를 다시 거칩니다.
선택사항: 위치 타겟팅 지정
기본적으로 작업은 사용자의 기기 언어가 '영어' 변형 (예: 미국 영어 또는 영국 영어)으로 설정되어 있는 한 모든 지역에서 사용할 수 있습니다.
위치 타겟팅 설정은 작업의 지역별 사용 가능 여부를 제어합니다.
현지화된 게시에 관해 자세히 알아보세요.
선택사항: 노출 영역 기능 지정
작업은 휴대전화 (Android 및 iOS)와 스마트 디스플레이 등 어시스턴트가 지원하는 다양한 표시 경로에 표시될 수 있습니다.
노출 영역 기능을 사용하면 사용자가 사용하는 노출 영역에 따라 사용자가 작업을 호출할 수 있는지 여부를 제어할 수 있습니다. 사용자가 지원되지 않는 노출 영역에서 작업을 호출하려고 하면 기기가 지원되지 않는다는 오류 메시지가 표시됩니다.
노출 영역 기능에 관해 자세히 알아보세요.
선택사항: Interactive Canvas 옵션 지정
작업에서 Interactive Canvas를 사용한다면 왼쪽 탐색 메뉴의 Develop > Interactive Canvas에서 몇 가지 옵션을 사용 설정하고 설정해야 합니다.
- 작업에서 Interactive Canvas를 사용하는 옵션을 사용 설정합니다.
- 작업의 시각 자료를 호스팅하는 웹 앱의 URL을 입력합니다.
시뮬레이터로 테스트
작업을 출시하기 전에 시뮬레이터를 사용하여 작업의 사용자 환경을 테스트하고 모든 것이 제대로 작동하는지 확인합니다.
다음과 같은 일반적인 오류 및 위반사항이 있는지 확인합니다.
- 웹훅 전송은 안전해야 합니다. 웹훅 전송에 HTTPS (TLS) 암호화를 사용하는지 확인합니다.
- 웹훅 요청 확인: Actions SDK를 사용하여 웹훅 요청에 서명하고 웹훅에서 이를 확인합니다.
- 작업 이름 테스트: 설정한 작업 이름이 작업을 일관되게 트리거하는지 확인합니다. 하드웨어 기기 또는 웹 시뮬레이터를 사용하여 다양한 실제 시나리오 (예: 배경에 노이즈가 있거나 기기에서 멀리 떨어져 있음)에서 호출 이름을 반복해서 말합니다. 가능하다면 성별이나 억양이 다른 사람들에게 작업을 호출하도록 요청하세요. 호출 이름이 일관되게 인식되지 않으면 이름을 변경하는 것이 좋습니다.
- 실제 기기에서 테스트: 웹 시뮬레이터는 개발 중에 작업을 빠르게 테스트하는 데 적합하지만 항상 실제 기기에서 호출과 대화상자를 테스트해야 합니다. 이는 실생활에서 작업이 어떻게 작동하는지 이해하고 사용자 환경을 개선하는 데 도움이 되는 가장 좋은 방법입니다.
현재 작업 프로젝트 초안을 테스트하려면 기본 탐색 메뉴에서 테스트로 이동합니다. 이렇게 하면 시뮬레이터, 콘솔, 어시스턴트 지원 기기에서 작업의 현재 버전이 사용됩니다.
작업 시뮬레이터에 관해 자세히 알아보세요.
프로젝트 출시
프로젝트 초안을 테스트하고 결과에 만족하면 추가 테스트를 위해 알파 또는 베타 채널에 배포할 수 있습니다. 또는 검토를 위해 앱을 제출하고 어시스턴트 사용자에게 출시할 수 있습니다.
콘솔의 배포 > 출시 섹션에는 다음과 같은 출시 옵션이 표시됩니다.
- 알파: 빠른 테스트 반복에 가장 적합합니다. 작업은 전체 Google 검토를 거치지 않고 개발자가 정의한 소수의 사용자에게 배포됩니다.
- 베타: 전체 Google 검토 후 제한된 사용자 그룹에 작업을 배포하는 데 가장 적합합니다. 작업이 전체 검토를 통과했으므로 언제든지 공개할 수 있습니다.
- 프로덕션: 전체 Google 검토를 위해 작업을 제출합니다. 승인되면 어시스턴트 사용자가 작업을 사용할 수 있습니다.
버전에 대해 자세히 알아보세요.
배포 상태
다음 표에서는 프로젝트의 다양한 배포 상태와 수행해야 할 수 있는 추가 단계를 설명합니다.
| 배포 상태 | 설명 |
|---|---|
| 검토 중 |
새 배포를 제출하면 승인 프로세스를 거칩니다. 검토자는 작업을 테스트하고 정책을 위반하지 않았는지 확인합니다. 검토가 완료되면 배포 승인 여부를 알려주는 이메일이 전송됩니다. |
| 거부됨 | 거부됨 상태는 배포가 승인되지 않았음을 의미합니다. 배포가 거부된 이유를 설명하는 이메일이 전송됩니다. 콘솔에서 거부됨 상태 옆에 있는 이유를 클릭하여 거부 이유를 확인할 수도 있습니다. |
| 배포됨 | 활성 상태이며 사용자에게 게재 중인 승인된 작업입니다. 언제든지 콘솔에서 배포된 버전을 '게시 중단'할 수 있습니다. |
| 승인됨 | 검토를 통과했으며 현재 사용자에게 제공되지 않는 작업입니다. 작업이 이미 검토를 통과한 경우 추가 검토를 거치지 않고 언제든지 콘솔에서 해제될 수 있습니다. |
| 비정상 | Google은 정기적으로 작업의 엔드포인트로 요청을 전송하고 적절한 응답을 받는지 확인합니다. 엔드포인트가 다운되거나 응답하지 않는 것이 감지되면 사용자를 대상으로 한 작업 제공이 일시적으로 중지됩니다. 이 경우 엔드포인트가 비정상이며 작업이 비정상 상태로 전환되었음을 알려주는 이메일을 받게 됩니다. 엔드포인트가 다시 응답하는 것이 감지되면 즉시 사용자에게 작업 제공이 재개됩니다. 이 경우 이메일이 발송되며 배포 상태가 배포됨으로 돌아갑니다. |
| 게시 중단 | 배포 후 정책 위반이 감지되면 Google에서 작업을 게시 중단할 수 있습니다. 이 경우 이메일이 전송되고 개발자 콘솔에 작업이 게시 중단되었음을 알리는 배너도 표시됩니다. 이유를 클릭하면 근거를 확인하고 정책 위반을 수정하거나 결정에 이의신청하는 옵션을 확인할 수 있습니다. |
프로젝트 버전 관리
시간이 지남에 따라 작업에 관한 정보를 업데이트하는 것이 좋습니다. 작업을 변경하면 프로젝트의 새 버전이 생성됩니다. 업데이트된 작업을 출시하여 일반에 공개하기 전에 각각의 새 버전을 다시 제출하여 전체 검토 프로세스를 거쳐야 합니다.
다음 중 하나라도 변경하려면 작업을 다시 제출하여 검토를 받아야 합니다.
- 콘솔에서 프로젝트의 설명, 아이콘 또는 기타 메타데이터를 수정합니다.
- Actions Builder 또는 Actions SDK를 사용하여 작업 프로젝트를 변경했습니다.
- 기존 Actions SDK를 사용하여 작업 패키지를 변경했습니다.
- Dialogflow를 사용하여 Dialogflow 에이전트를 변경했습니다.
다음 시나리오에서는 프로젝트를 다시 제출할 필요가 없습니다.
- 외부에서 호스팅되는 웹훅, Actions Builder의 인라인 웹훅 편집기, Dialogflow의 인라인 편집기에서만 코드를 변경했습니다.
- 템플릿을 사용하며 콘텐츠를 Google 시트에 업로드하여 템플릿 데이터를 업데이트했습니다.
검토를 위해 업데이트된 작업을 제출하려면 배포 > 출시로 이동하여 버전 만들기를 클릭합니다. 승인되면 이전 버전은 배포 취소되고 어시스턴트 사용자는 최신 버전의 작업을 사용할 수 있습니다.
버전 추적 및 수정
버전 정보를 추적하고 가져오려면 배포 > 출시로 이동하여 정보를 확인할 버전을 클릭합니다.
표에는 최종 수정일과 버전의 현재 상태가 표시됩니다. 버전의 현재 상태에 따라 상태를 구체적으로 변경할 수 있습니다.
- 버전이 검토 중인 경우 검토에서 버전을 철회하도록 선택할 수 있습니다.
- 버전이 배포되면 프로덕션에서 배포 취소를 선택하여 작업을 중단할 수 있습니다.
- 이전 버전이 배포 취소된 경우 프로덕션에 배포를 선택하여 해당 버전으로 되돌릴 수 있습니다.