고급 Google 서비스

숙련된 개발자는 Apps Script의 고급 서비스를 사용하여 특정 공개 Google API는 HTTP 인터페이스 사용보다 설정이 적습니다. 고급 서비스는 기본적으로 이러한 Google API를 둘러싼 얇은 래퍼입니다. 그들은 GKE는 Apps Script의 내장된 서비스를 제공합니다. 예를 들어 자동 완성을 지원하며 Apps Script에서 승인 절차가 자동으로 진행됩니다. 하지만 먼저 고급 서비스를 사용 설정해야 스크립트에서 사용할 수 있습니다.

고급 서비스로 사용할 수 있는 Google API를 확인하려면 고급 Google 서비스 섹션에 표시된 참조. 특정 스테이트리스(Stateless) 컨테이너를 실행하는 은(는) 고급 서비스로 사용할 수 없습니다. 다른 것과 마찬가지로 연결하면 됩니다. 외부 API

고급 서비스 또는 HTTP?

각 고급 Google 서비스는 공개 Google API와 연결되어 있습니다. Apps Script에서는 고급 서비스를 통해 또는 간단히 API를 사용하여 UrlFetch

고급 서비스 방법을 사용하는 경우 Apps Script에서 다음을 처리합니다. 승인 절차와 자동 완성이 지원됩니다. 하지만 고급 서비스를 사용 설정해야 있습니다. 또한 일부 고급 서비스는 기능을 사용할 수 있습니다.

UrlFetch 메서드를 사용하여 API에 직접 액세스하는 경우 기본적으로 Google API를 외부 API 이 방법을 사용하면 API의 여러 측면을 활용할 수 있습니다 하지만 API를 처리해야 하므로 사용할 수 있습니다. 또한 필요한 헤더를 구성하고 파싱해야 합니다. API 응답입니다

일반적으로 가능한 경우 고급 서비스를 사용하는 것이 가장 쉽고 고급 서비스에서 UrlFetch 메서드를 사용할 수 있습니다.

요구사항

고급 서비스를 사용하려면 다음 요건을 충족해야 합니다. 요구사항:

  1. 고급 서비스를 사용 설정해야 합니다. 생성합니다.
  2. 고급 서비스에 해당하는 API가 사용 설정되어 있는지 확인해야 합니다. Cloud Platform (GCP) 프로젝트 확인할 수 있습니다.

    스크립트 프로젝트가 기본 GCP 프로젝트를 사용하는 경우 2019년 4월 8일 이후에 생성된 경우 API가 자동으로 사용 설정됩니다. 스크립트 프로젝트를 저장한 후 만약 아직 하지 않으셨다면 Google CloudGoogle API 서비스 약관도 준수해야 합니다.

    스크립트 프로젝트가 표준 GCP 프로젝트 또는 이전 기본 GCP 프로젝트를 고급 서비스의 해당 API를 사용 설정해야 합니다. 이를 GCP 프로젝트에서 수동으로 생성합니다. GCP 프로젝트에 대한 수정 액세스 권한이 있어야 합니다. 이렇게 변경할 수 있습니다

Cloud Platform 프로젝트 보기 를 참조하세요.

고급 서비스 사용 설정

고급 Google 서비스를 사용하려면 다음 안내를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 편집기 를 클릭합니다.
  3. 왼쪽의 서비스 옆에 있는 서비스 추가를 클릭합니다. 입니다.
  4. 고급 Google 서비스를 선택하고 추가를 클릭합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.

고급 서비스를 사용 설정하면 자동 완성에서 사용할 수 있습니다.

메서드 서명 결정 방법

고급 서비스는 일반적으로 동일한 객체, 메서드 이름 및 매개변수를 사용 를 해당 공개 API로 제공하지만, 메서드 서명은 사용할 수 있습니다. 스크립트 편집기의 자동 완성 함수 보통 시작하는 데 필요한 정보를 충분히 제공하지만, 아래 규칙을 통해 Apps Script가 공개 Google API에서 메서드 서명을 생성하는 방법

Google API에 대한 요청은 다양한 유형의 데이터를 허용할 수 있습니다. 경로 매개변수, 쿼리 매개변수, 요청 본문, 미디어 포함 첨부파일을 업로드합니다. 일부 고급 서비스는 특정 HTTP 요청을 수락할 수도 있습니다. 헤더 (예: Calendar 고급 서비스).

Google Apps Script에서 해당 메서드 서명에는 다음이 포함됩니다. 인수:

  1. JavaScript 객체인 요청 본문 (일반적으로 리소스)입니다.
  2. 경로 또는 필수 매개변수(개별 인수로)입니다.
  3. 미디어 업로드 첨부파일(Blob) 인수입니다.
  4. 매개변수 이름을 값으로 사용됩니다.
  5. 헤더 이름을 헤더에 매핑하는 JavaScript 객체로서의 HTTP 요청 헤더 값으로 사용됩니다.

메서드의 지정된 카테고리에 항목이 없으면 서명이 생략되었습니다.

다음과 같은 특별한 예외 사항이 있습니다.

  • 미디어 업로드를 허용하는 메서드의 경우 uploadType 매개변수가 설정됩니다. 자동으로 확장 및 축소할 수 있습니다
  • Google API에서 delete이라는 메서드는 Apps Script에서 remove로 이름이 지정됩니다. delete는 JavaScript에서 예약어이기 때문입니다.
  • 고급 서비스가 HTTP 요청 헤더를 수락하도록 구성되어 있고 요청 헤더 자바스크립트 객체를 설정한 경우 선택적 매개변수 JavaScript 객체 (사용하지 않는 경우 빈 객체에 선택적 매개변수).

고급 서비스 지원

고급 서비스는 Google 애플리케이션을 사용할 수 있도록 하는 얇은 래퍼에 불과합니다. API에 대해 배웠습니다. 따라서 사용 중 발생하는 모든 문제는 일반적으로 Apps Script 자체가 아니라 기본 API에 문제가 있습니다.

고급 서비스를 사용하는 동안 문제가 발생하면 기본 API의 지원 안내를 사용하여 보고되었습니다. 관련 링크 지원 지침은 Apps Script 참조 섹션에 표시됩니다.