링크 첨부파일을 클래스룸 부가기능 첨부파일로 업그레이드하기

교사가 클래스룸에 서드 파티 콘텐츠를 추가하는 한 가지 방법은 과제 만들기 페이지에서 링크를 링크 첨부파일로 붙여넣을 수 있습니다. 빌드하려면 이미 익숙한 기능을 사용했다면 이제 부가기능을 구성하여 교사가 링크 첨부파일을 부가기능 첨부파일로 업그레이드하도록 허용합니다.

개요

이 기능을 사용해 부가기능을 구성하면 교사에게 링크를 부가기능 첨부파일로 업그레이드하는 경우 과제 만들기 페이지 교사는 이미 부가기능이 설치되어 있어야 합니다

교사가 링크를 부가기능 첨부파일로 업그레이드하는 데 동의하면 링크 업그레이드 iframe은 다음 쿼리 매개변수를 사용하여 실행됩니다.

courseId
itemId
itemType
addOnToken
urlToUpgrade
login_hint (사용자가 이미 앱을 승인한 경우만)

처음 네 개의 검색어 매개변수는 Google 디스플레이 네트워크에서 실행된 검색어 매개변수를 첨부파일 검색 iframe. urlToUpgrade 쿼리 매개변수는 새 쿼리 매개변수이며 부가기능 첨부파일을 만드는 방법을 평가하는 데 도움이 됩니다. 그런 다음 다른 쿼리 매개변수를 사용하여 사용자가 로그인되어 있는지 확인하고 courseWork, courseWorkMaterials의 CreateAddOnAttachment 메서드 또는 itemType 값을 기반으로 하는 announcements입니다. iframe 내에서 교사에게 부가기능 첨부파일이 있음을 알리는 로딩 화면 표시 만드는 중입니다.

부가기능 첨부파일이 만들어지면 iframe이 닫히고 선생님은 평소처럼 과제의 첨부파일을 볼 수 있습니다.

기술 구현 세부정보

이 섹션에서는 이 기능에 대한 몇 가지 중요한 기술적 세부정보를 중점적으로 설명합니다.

`urlToUpgrade` 쿼리 매개변수 읽기

urlToUpgrade 쿼리 매개변수는 Link에서 전달될 때 URI로 인코딩됩니다. iframe 업그레이드 URL을 원래 형태로 가져오려면 디코딩해야 합니다. 만약 JavaScript를 사용하는 경우, 예를 들어 decodeURIComponent() 함수를 사용하여 이를 수행합니다.

링크 업그레이드 iframe 닫기

이 기능에 대한 최적의 사용자 환경을 제공하려면 postMessage를 한 번 전송합니다. 부가기능 첨부파일이 성공적으로 생성되었습니다. 이렇게 하면 iframe이 닫힙니다. 자세한 내용은 iframe 구현 세부정보 페이지를 참조하세요.

구성 세부정보

이 기능을 부가기능:

링크 업그레이드 iframe의 URL: 교사가 업그레이드에 동의하면 iframe이 표시됩니다.
클래스룸에서 감지하고 시도해야 하는 URL 패턴 업그레이드: URL 패턴은 호스트 및 여러 경로로 구성될 수 있음 접두사로 대체합니다.
- 여러 URL 패턴을 제공할 수 있습니다.
- 경로 프리픽스를 제공하지 않으면 호스트와 일치하는 모든 URL입니다. 업그레이드할 수 있습니다
- https 스키마를 사용하는 URL만 업그레이드할 수 있습니다.
- URL 패턴은 localhost를 포함할 수 없습니다.
- 경로 프리픽스에는 쿼리 매개변수 또는 URL 프래그먼트가 포함되면 안 됩니다.
- 현재 경로 접두사는 와일드 카드를 지원하지만 호스트는 지원하지 않습니다. <ph type="x-smartling-placeholder">
  - example.com는 유효한 호스트입니다. /foo 및 /bar/*/baz는 유효한 경로 접두사입니다.
  - example.*.host.com은(는) 다음 항목이 아닙니다. 유효한 호스트입니다.
- 경로 접두어 구성요소 사이의 와일드 카드는 단일 문자열과만 일치합니다. 구성요소이며, 슬래시로 구분된 여러 구성요소와 일치하지 않습니다. 호스트 example.com 및 경로 프리픽스가 있는 URL 패턴을 고려하세요. /bar/*/baz: <ph type="x-smartling-placeholder">
  - https://example.com/bar/123/baz은(는) URL에 대한 유효한 일치 항목입니다. 학습합니다.
  - https://example.com/bar/123/baz/456/789는 URL 패턴입니다.
  - https://example.com/bar/123/456/baz은(는) 다음에 대한 올바른 일치 항목이 아닙니다. 경로 접두사의 와일드 카드가 일치하지 않으므로 URL 패턴입니다. /123/456/입니다.

개발 프로세스

테스트 또는 프로덕션을 위해 링크 업그레이드 iframe URL 및 URL 패턴을 전송하세요. classroom-link-upgrade-external@google.com으로 이메일을 보내어 부가기능 지원 기능을 사용할 수 있습니다.

Google Cloud를 나타내는 모든 Google Cloud 프로젝트에 대한 구성을 클래스룸 부가기능. 먼저 비공개 가시성을 사용하여 부가 기능에 대한 구성을 생성하여 실제 사용자에게 영향을 주지 않고 데모 도메인에서 테스트할 수 있습니다.

구성이 완료되면 이메일로 답변을 받게 됩니다. 사용 설정되어 있습니다. 이 경우 localhost를 사용하는 URL 패턴은 지원되지 않습니다. 기능을 사용할 수 있습니다.

다음을 포함하도록 이메일 형식을 지정합니다.

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

다음을 바꿉니다.

GCP_PROJECT_NUMBER: Google Cloud 프로젝트의 번호 확인할 수 있습니다
LINK_UPGRADE_IFRAME_URL: 링크 업그레이드 iframe
HOST_1: 클래스룸에서 감지해야 하는 호스트입니다. 이 https 스키마가 지원됩니다.
PATH_PREFIX_1 및 PATH_PREFIX_2: 경로 클래스룸에서 감지하고 시도해야 하는 HOST_1에 연결된 접두사 업그레이드할 수 있습니다
HOST_2: 클래스룸에서 감지해야 하는 호스트입니다. 이 https 스키마가 지원됩니다.
PATH_PREFIX_3 및 PATH_PREFIX_4: 경로 클래스룸에서 감지하고 시도해야 하는 HOST_2에 연결된 접두사 업그레이드할 수 있습니다

권장 사용자 환경

다음은 이 기능을 구현할 때 고려해야 할 제안사항입니다.

교사의 추가 작업 방지

다음과 같은 경우 iframe을 사용하여 로그인을 용이하게 하는 것이 좋습니다. 로드 표시기를 표시할 수도 있습니다. 최상의 사용자 환경을 위해 교사에게 추가 정보를 묻는 메시지가 님이 붙여넣은 링크를 부가기능 첨부파일로 업그레이드하는 데 동의했습니다. 그러나 링크 업그레이드 iframe을 이용해 필요한 추가 정보가 있습니다. iframe은 링크를 업그레이드할 수 없거나 오류가 발생한 경우 교사에게 문의하세요.

사용자 친화적인 액세스 오류 메시지 포함

교사가 액세스 권한이 없는 링크를 붙여넣고 업그레이드하는 경우 iframe에 사용자 친화적인 오류 메시지를 포함하여 교사가 문제를 인지할 수 있도록 합니다. iframe을 사용하여 교사에게 적절한 콘텐츠에 액세스할 수 있는 권한을 보유하고 있어야 합니다.