부가기능 사전 체험판의 미리보기 메서드

사전 체험판 또는 비공개 미리보기 프로그램의 API 메서드는 비공개입니다. 즉, 표준 클라이언트 라이브러리에 노출되지 않으며 기본적으로 HTTP를 통해 액세스할 수 있습니다 이 페이지에서는 이러한 기능에 액세스하는 방법을 설명합니다. 미리 볼 수 있습니다.

이 문서에서는 미리보기 API를 사용하기 위한 네 가지 옵션을 설명합니다.

  1. Google에서 제공하는 정적 클라이언트 라이브러리
  2. 동적으로 생성된 클라이언트 라이브러리
  3. 직접 HTTP 요청
  4. 자체 커스텀 클라이언트 라이브러리

Google에서 제공하는 정적 라이브러리나 동적으로 생성된 라이브러리를 사용하는 방법은 다음과 같습니다. 권장하는 방법입니다.

정적 라이브러리

Java, Node.js, PHP, C# 과 같은 언어로 된 클라이언트 라이브러리는 있습니다. 이 라이브러리는 클라이언트 라이브러리 다운로드에서 제공됩니다. 프리뷰 메서드가 이미 있어야 합니다.

이러한 종속 항목을 사용하려면 일반적인 종속 항목 구성을 수정해야 할 수도 있습니다. 로컬 라이브러리를 가져오는 것보다 미리보기 메서드가 있습니다.

예를 들어 Node.js와 npm을 사용하는 경우 Node.js 클라이언트 라이브러리를 추가합니다. 다음 위치에 로컬 종속 항목으로 다운로드 (googleapis-classroom-1.0.4.tgz) package.json:

{
  "name": "nodejs-classroom-example",
  "version": "1.0.0",
  ...
  "dependencies": {
    "@google-cloud/local-auth": "^2.1.0",
    "googleapis": "^95.0.0",
    "classroom-with-addons": "file:./googleapis-classroom-1.0.4.tgz"
  }
}

그런 다음 애플리케이션에서 classroom-with-addons 모듈 외에도 일반 종속 항목으로 연결하고, 거기에서 classroom 서비스를 인스턴스화합니다. 모듈:

const {authenticate} = require('@google-cloud/local-auth');
const {google} = require('googleapis');
const classroomWithAddons = require('classroom-with-addons');

...

const classroom = classroomWithAddons.classroom({
  version: 'v1',
  auth: auth,
});

...

동적 라이브러리

Python과 같은 언어의 라이브러리는 런타임 시 검색 서비스의 검색 문서

증거 검색 문서는 컴퓨터가 읽을 수 있는 사양으로, REST API를 사용할 수 있습니다 클라이언트 라이브러리, IDE 플러그인, 애플리케이션 개발을 Google API와 상호작용하는 다른 도구들입니다. 하나의 서비스는 여러 개의 문서도 제공합니다

Classroom API 서비스의 문서 검색 (classroom.googleapis.com)는 다음 엔드포인트에서 찾을 수 있습니다.

  • https://classroom.googleapis.com/$discovery/rest?labels=<PREVIEW_LABEL>&version=v1&key=<PREVIEW_LABEL>

Python 라이브러리를 생성하고 다음을 사용하여 클래스룸 서비스를 인스턴스화합니다. 방법을 알고 있는 경우 적절한 서비스를 사용하여 Discovery URL을 지정할 수 있습니다. 사용자 인증 정보, 라벨:

classroom_service_with_rubrics = googleapiclient.discovery.build(
  serviceName="classroom",
  version="v1",
  credentials=credentials,
  static_discovery=False,
  discoveryServiceUrl=f"https://classroom.googleapis.com/$discovery/rest?labels=ADD_ONS_ALPHA&key=ABCXYZ")

각 항목에 대한 자세한 내용은 개별 Google API 클라이언트 라이브러리 문서를 참조하세요. 있습니다. 미리보기 API 작업 시 중요한 차이점은 적절한 label를 사용해야 합니다. 이 미리보기에서 라벨은 ADD_ONS_ALPHA입니다.

HTTP 요청

클라이언트 라이브러리 없이 HTTP 요청을 하는 경우 (ADD_ONS_ALPHA)을 X-Goog-Visibilities 헤더로 사용합니다.

예를 들어 게시물 아래에 있는 부가기능에서 생성한 모든 첨부파일을 보려면 다음 curl 요청을 실행합니다.

curl \
  'https://classroom.googleapis.com/v1/courses/[courseId]/courseWork/[itemId]/addOnAttachments?key=[YOUR_API_KEY]' \
  --header 'X-Goog-Visibilities: ADD_ONS_ALPHA' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --compressed

각 HTTP 요청에 대한 API는 REST 문서에 설명되어 있습니다.

커스텀 클라이언트 라이브러리

자체 라이브러리를 빌드해야 하는 경우 클라이언트 라이브러리 빌드를 참조하세요. 생성 중 내 라이브러리는 이 가이드에서 다루지 않지만 동적 라이브러리 섹션을 참조하세요. 탐색: