가젯 자바스크립트 참조

이 문서에서는 gadgets.* 네임스페이스의 클래스와 메서드를 설명하며 그중 일부는 기능별입니다. 기능 포함에 대한 자세한 내용은 가젯 사양을 참조하세요.

유형 규칙

이 문서에서는 유형에 다음과 같은 규칙을 사용합니다.

Array< 또는 Array.<lt>
Array는 T 유형의 객체로만 채워집니다. 이 규칙은 자바 제네릭과 비슷합니다.
Map<K, V> 또는 Map.<K, V>
K 유형의 키가 있는 자바스크립트 객체로 V 유형의 값에 매핑됩니다. 마찬가지로 이 규칙은 자바 제네릭과 유사합니다. 보통 opt_params 변수에 사용됩니다.
정적
정적 클래스로 표시된 유형에는 공개 또는 비공개 생성자가 없습니다. 즉, 유형은 객체를 만들기 위해 인스턴스화할 수 있는 클래스가 아닌 네임스페이스입니다. 이러한 유형의 필드 및 함수도 정적으로 표시됩니다.
불리언
부울 값 (Boolean 객체가 아님)
문자열
문자열 값 (String 객체 아님)입니다.

맨 위로

가젯 가젯.미니메시지

MiniMessage 클래스로, 가젯 내에서 사용자에게 표시할 메시지를 만드는 데 사용됩니다. 일반적인 사용 사례:

  • 상태 메시지 - 로드, 저장 등
  • 프로모션 메시지 — 새로운 기능, 새로운 가젯 등
  • 디버그/오류 메시지: 잘못된 입력, 서버 연결 실패 등

생성자 요약

gadgets.MiniMessage(opt_moduleId, opt_container)
미니 메시지를 만듭니다.
 

메소드 요약

 HTMLElement createDismissibleMessage(message, opt_callback)
사용자가 메시지를 닫을 수 있는 [x] 아이콘을 사용하여 닫을 수 있는 메시지를 만듭니다.
 HTMLElement createStaticMessage(message)
DismissMessage()를 호출하여 프로그래매틱 방식으로 닫을 수 있는 정적 메시지를 만듭니다.
 HTMLElement createTimerMessage(message, seconds, opt_callback)
지정된 시간(초) 동안 표시되는 메시지를 만듭니다.
dismissMessage(message)
지정된 메시지를 닫습니다.
 

생성자 세부정보

가젯 가젯 미니 메시지

gadgets.MiniMessage(opt_moduleId, opt_container)
    MiniMessage를 만듭니다.
    매개변수:
      String opt_moduleId - 선택적 모듈 ID
      HTMLElement opt_container - 미니 메시지가 표시될 HTML 컨테이너 요소(선택사항)

메소드 세부정보

createDismissibleMessage

HTMLElement createDismissibleMessage(message, opt_callback)
    사용자가 메시지를 닫을 수 있는 [x] 아이콘을 사용하여 닫을 수 있는 메시지를 만듭니다. 메시지가 닫히면 메시지가 DOM에서 삭제되고 선택적 콜백 함수가 호출됩니다(정의된 경우).
    매개변수:
      String, Object message - 메시지를 HTML 문자열 또는 DOM 요소로 표현
      Function opt_callback - 메시지를 닫을 때 호출할 선택적 콜백 함수
    반환:
      생성된 메시지의 HTML 요소 HTMLElement 

      createStaticMessage

      HTMLElement createStaticMessage(message)
        프로그래매틱 방식으로만 닫을 수 있는 정적 메시지를 만듭니다(DismissMessage()를 호출하여).
        매개변수:
          String, Object message - 메시지가 HTML 문자열 또는 DOM 요소로 사용됩니다.
        반환:
          생성된 메시지의 HTMLElement  HTML 요소
      }

      create 타이머 메시지

      HTMLElement createTimerMessage(message, seconds, opt_callback)
        지정된 시간(초) 동안 표시되는 메시지가 생성됩니다. 타이머가 만료되면 메시지가 닫히고 콜백 함수가 선택적으로 실행됩니다.
        매개변수:
          String, Object message - 메시지를 HTML 문자열 또는 DOM 요소로 표시
          number seconds - 메시지를 닫기 전에 대기할 시간(초)
          Function opt_callback - 메시지를 닫을 때 호출할 선택적 콜백 함수
        반환:
          HTMLElement  HTML {1
        {1

        메시지 닫기

        dismissMessage(message)
          지정된 메시지를 닫습니다.
          매개변수:
            HTMLElement message - 삭제할 메시지의 HTML 요소

        맨 위로

        Gadgets.Prefs 클래스

        사용자 환경설정, 모듈 크기, 메시지에 대한 액세스를 제공합니다. 클라이언트는 Gadgets.Prefs 인스턴스를 구성하고 모듈 ID를 전달하여 환경설정에 액세스할 수 있습니다. 예:

        var prefs = new gadgets.Prefs();
        var name = prefs.getString("name");
        var lang = prefs.getLang();

        생성자 요약

        gadgets.Prefs(opt_moduleId)
        새 Prefs 객체를 만듭니다.
         

        메소드 요약

         Array.<String> getArray(key)
        환경설정을 배열로 검색합니다.
         Boolean getBool(key)
        환경설정을 부울로 검색합니다.
         String getCountry()
        현재 국가를 가져오고 ISO 3166-1 alpha-2 코드로 반환됩니다.
         Number getFloat(key)
        환경설정을 부동 소수점 값으로 검색합니다.
         Number getInt(key)
        환경설정을 정수로 검색합니다.
         String getLang()
        렌더링할 때 가젯이 사용해야 하는 현재 언어를 가져옵니다. ISO 639-1 언어 코드로 반환됩니다.
         String, Number getModuleId()
        현재 인스턴스의 모듈 ID를 가져옵니다.
         String getMsg(key)
        형식이 지정되지 않은 메시지를 가져옵니다.
         String getString(key)
        환경설정을 문자열로 검색합니다.
        set(key, val)
        환경설정을 저장합니다.
        setArray(key, val)
        배열 환경설정을 저장합니다.
         

        생성자 세부정보

        가젯.사전 설정

        gadgets.Prefs(opt_moduleId)
          새 Prefs 객체를 만듭니다.
          매개변수:
            String, Number opt_moduleId - prefs를 생성할 모듈 ID를 지정하는 선택적 매개변수입니다. 제공되지 않으면 기본 모듈 ID가 사용됩니다.

        메소드 세부정보

        getArray

        Array.<String> getArray(key)
          환경설정을 배열로 검색합니다. 목록으로 선언되지 않은 UserPref 값은 단일 요소 배열로 취급됩니다.
          매개변수:
            String key - 가져올 환경설정
          반환:
            Array.<String>  설정, 비어 있는 배열

        getBool

        Boolean getBool(key)
          환경설정을 부울로 검색합니다.
          매개변수:
            String key - 가져올 환경설정
          반환:
            Boolean  환경설정, 설정하지 않으면 false

        getCountry

        String getCountry()
          ISO 3166-1 alpha-2 코드로 반환되는 현재 국가를 가져옵니다.
          반환:
            String  이 모듈 인스턴스의 국가

        getFloat

        Number getFloat(key)
          환경설정을 부동 소수점 값으로 검색합니다.
          매개변수:
            String key - 가져올 환경설정
          반환:
            Number  환경설정, 설정하지 않은 경우 0

        getInt

        Number getInt(key)
          환경설정을 정수로 검색합니다.
          매개변수:
            String key - 가져올 환경설정
          반환:
            Number  환경설정, 설정하지 않은 경우 0

        get 언어

        String getLang()
          렌더링 시 가젯에서 사용해야 하는 현재 언어를 가져옵니다. ISO 639-1 언어 코드로 반환됩니다.
          반환:
            String  이 모듈 인스턴스의 언어

        getModuleId

        String, Number getModuleId()
          현재 인스턴스의 모듈 ID를 가져옵니다.
          반환:
            String, Number  이 모듈 인스턴스의 모듈 ID

        getGsg

        String getMsg(key)
          형식이 지정되지 않은 메시지를 가져옵니다.
          매개변수:
            String key - 가져올 메시지
          반환:
            String  메시지

        getString

        String getString(key)
          환경설정을 문자열로 검색합니다.
          매개변수:
            String key - 가져올 환경설정
          반환:
            String  환경설정, 설정되지 않은 경우 빈 문자열

        set

        set(key, val)
          환경설정을 저장합니다. 이 호출을 사용하려면 가젯에 기능 setprefs가 필요합니다.

          참고: 가젯이 배열을 저장해야 하는 경우 이 호출 대신 setArray를 사용해야 합니다.

          매개변수:
            String key - 저장할 환경설정
            Object val - 저장할 값

        setArray

        setArray(key, val)
          배열 환경설정을 저장합니다. 이 호출을 사용하려면 가젯에 기능 setprefs가 필요합니다.
          매개변수:
            String key - 저장할 pref
            Array val - 저장할 값

        맨 위로

        Gadgets.Tab 클래스

        가젯의 탭 클래스입니다. TabSet addTab() 메서드를 사용하여 탭을 만듭니다. Tab 객체를 가져오려면 TabSet getSelectedTab() 또는 getTabs() 메서드를 사용하세요.

        참고 항목: TabSet

        메소드 요약

         Function getCallback()
        탭을 선택하면 실행되는 콜백 함수를 반환합니다.
         HTMLElement getContentContainer()
        탭 콘텐츠가 렌더링되는 HTML 요소를 반환합니다.
         Number getIndex()
        탭의 색인을 반환합니다.
         String getName()
        탭의 라벨을 문자열로 반환합니다 (HTML 포함 가능).
         HTMLElement getNameContainer()
        탭 라벨이 포함된 HTML 요소를 반환합니다.
         

        메소드 세부정보

        콜백 가져오기

        Function getCallback()
          탭이 선택될 때 실행되는 콜백 함수를 반환합니다.
          반환:
            Function  탭의 콜백 함수

        getContentContainer

        HTMLElement getContentContainer()
          탭 콘텐츠가 렌더링되는 HTML 요소를 반환합니다.
          반환:
            HTMLElement  콘텐츠 컨테이너의 HTML 요소

        getIndex

        Number getIndex()
          탭의 색인을 반환합니다.
          반환:
            Number  탭 색인

        getName

        String getName()
          탭의 라벨을 문자열로 반환합니다 (HTML 포함 가능).
          반환:
            String  탭 라벨

        getNameContainer

        HTMLElement getNameContainer()
          탭 라벨이 포함된 HTML 요소를 반환합니다.
          반환:
            HTMLElement  탭 라벨의 HTML 요소

        맨 위로

        Gadgets.TabSet 클래스

        수업 가젯이 탭을 만드는 데 사용할 수 있습니다.

        생성자 요약

        gadgets.TabSet(opt_moduleId, opt_defaultTab, opt_container)
        새 TabSet 객체를 만듭니다.

        메소드 요약

         String addTab(tabName, opt_params)
        opt_params에 지정된 이름-값 쌍을 기반으로 새 탭을 추가합니다.
        alignTabs(align, opt_offset)
        탭의 정렬을 설정합니다.
        displayTabs(display)
        탭 및 연결된 모든 콘텐츠를 표시하거나 숨깁니다.
         HTMLElement getHeaderContainer()
        탭 헤더 컨테이너 요소를 반환합니다.
         gadgets.Tab getSelectedTab()
        현재 선택된 탭 객체를 반환합니다.
         Array.<gadgets.Tab> getTabs()
        모든 기존 탭 객체의 배열을 반환합니다.
        removeTab(tabIndex)
        tabIndex 및 탭에서 연결된 모든 콘텐츠의 탭을 삭제합니다.
        setSelectedTab(tabIndex)
        TabIndex에서 탭을 선택하고 tab 콜백 함수가 있는 경우 이 함수를 실행합니다.
        swapTabs(tabIndex1, tabIndex2)
        tabIndex1 및 tabIndex2에서 탭의 위치를 바꿉니다.
         

        생성자 세부정보

        가젯 탭 탭

        gadgets.TabSet(opt_moduleId, opt_defaultTab, opt_container)
          새 TabSet 객체 만들기
          매개변수:
            String opt_moduleId - 탭 컨테이너 ID에 대한 선택적 접미사
            String opt_defaultTab - 이 매개변수를 생략하면 기본적으로 첫 번째 탭이 선택됩니다.
            HTMLElement opt_container{ -

          메소드 세부정보

          탭 추가

          String addTab(tabName, opt_params)
            Opt_params에 지정된 이름-값 쌍을 기반으로 새 탭을 추가합니다. 다음과 같은 속성은 Opt_params에서 지원됩니다.
            콘텐츠 컨테이너
            탭 콘텐츠 컨테이너로 사용할 기존 HTML 요소입니다. 생략하면 탭 라이브러리가 새 탭을 만듭니다.
            콜백
            탭이 선택될 때 실행될 콜백 함수입니다.
            도움말
            사용자가 탭 위로 마우스 커서를 이동할 때 팝업되는 도움말 설명
            index
            탭을 삽입할 색인입니다. 생략하면 새 탭이 끝에 추가됩니다.
            매개변수:
              String tabName - 생성할 탭 라벨
              Object opt_params - 선택적 매개변수 객체
            반환:
              String  탭 컨테이너의 DOM ID

          정렬 탭

          alignTabs(align, opt_offset)
            탭의 정렬을 설정합니다. 탭은 기본적으로 가운데에 정렬됩니다.
            매개변수:
              String align - '왼쪽

              디스플레이 탭

              displayTabs(display)
                탭과 모든 관련 콘텐츠를 표시하거나 숨깁니다.
                매개변수:
                  Boolean display - 탭을 표시하려면 True, 탭을 숨기려면 false입니다.

              헤더 헤더 가져오기

              HTMLElement getHeaderContainer()
                탭 헤더 컨테이너 요소를 반환합니다.
                반환:
                  HTMLElement  탭 헤더 컨테이너 요소

              getSelectedTab

              gadgets.Tab getSelectedTab()
                현재 선택된 탭 객체를 반환합니다.
                반환:
                  gadgets.Tab  현재 선택된 탭 객체

              getTab

              Array.<gadgets.Tab> getTabs()
                모든 기존 탭 객체의 배열을 반환합니다.
                반환:
                  Array.<gadgets.Tab>  모든 기존 탭 객체의 배열

              탭 삭제

              removeTab(tabIndex)
                tabIndex 및 탭에서 연결된 모든 콘텐츠의 탭을 삭제합니다.
                매개변수:
                  Number tabIndex - 삭제할 탭의 색인

              setSelectedTab

              setSelectedTab(tabIndex)
                tabIndex에서 탭을 선택하고 tab 콜백 함수가 있는 경우 이 함수를 실행합니다. 탭이 이미 선택되어 있으면 콜백이 실행되지 않습니다.
                매개변수:
                  Number tabIndex - 선택할 탭의 색인

              swapTab

              swapTabs(tabIndex1, tabIndex2)
                tabIndex1 및 tabIndex2에서 탭의 위치를 바꿉니다. 선택한 탭은 변경되지 않으며 콜백 함수가 호출되지 않습니다.
                매개변수:
                  Number tabIndex1 - 교체할 첫 번째 탭의 색인
                  Number tabIndex2 - 교체할 탭의 탭 색인

              맨 위로

              정적 클래스 가젯.플래시

              가젯에 Flash 콘텐츠를 삽입합니다.

              메소드 요약

              <static>  Boolean embedCachedFlash()
              캐시된 플래시 파일을 DOM 트리에 삽입합니다.
              <static>  Boolean embedFlash(swfUrl, swfContainer, swfVersion, opt_params)
              DOM 트리에 플래시 파일을 삽입합니다.
              <static>  Number getMajorVersion()
              플래시 플레이어와 주요 버전을 감지합니다.
               

              메소드 세부정보

              삽입 캐시 플래시

              <static> Boolean embedCachedFlash()
                캐시된 플래시 파일을 DOM 트리에 삽입합니다. 가젯s.플래시.삽입 플래시와 동일한 매개변수를 허용합니다.
                반환:
                  Boolean  함수 호출 완료 여부

              삽입 플래시

              <static> Boolean embedFlash(swfUrl, swfContainer, swfVersion, opt_params)
                DOM 트리에 플래시 파일을 삽입합니다.
                매개변수:
                  String swfUrl - JPEG URL
                  String, Object swfContainer - 기존 HTML 컨테이너 요소의 ID 또는 객체 참조
                  Number swfVersion - 필요한 최소 플래시 플레이어 버전
                  Object opt_params - 유효한 HTML 매개변수가 포함될 수 있는 선택적 객체. 모든 속성이 생성 시 플래시 영화로 전달됩니다.
                {1

              getMajorVersion

              <static> Number getMajorVersion()
                Flash Player와 주요 버전을 감지합니다.
                반환:
                  Number  플래시 플레이어의 주요 버전 또는 플래시가 지원되지 않는 경우 0

              맨 위로

              정적 클래스 가젯.io

              원격 콘텐츠 검색 기능을 제공합니다.

              메소드 요약

              <static>  String encodeValues(fields)
              입력 객체를 URL로 인코딩된 데이터 문자열로 변환합니다.
              <static>  String getProxyUrl(url, opt_params)
              전달된 URL의 프록시 버전을 가져옵니다.
              <static> makeRequest(url, callback, opt_params)
              제공된 URL에서 콘텐츠를 가져와 이 콘텐츠를 콜백 함수로 제공합니다.
               

              메소드 세부정보

              인코딩 값

              <static> String encodeValues(fields)
                입력 객체를 URL로 인코딩된 데이터 문자열로 변환합니다. (key=value&...;)
                매개변수:
                  Object fields - 인코딩하려는 게시물 필드
                반환:
                  String  처리된 게시물 데이터. 후행 앰퍼샌드 (&)

              getProxyUrl

              <static> String getProxyUrl(url, opt_params)
                전달된 URL의 프록시 버전을 가져옵니다.
                매개변수:
                  String url - 프록시에 가져올 프록시 URL입니다.
                  Map<String, String> opt_params - 요청에 전달할 추가 매개변수입니다.
                반환:
                  String  URL의 프록시 버전

              MakeRequest

              <static> makeRequest(url, callback, opt_params)
                제공된 URL에서 콘텐츠를 가져와 이 콘텐츠를 콜백 함수로 피드합니다. 예:
                var params = {};
                params[gadgets.io.RequestParameters.CONTENT_TYPE] = gadgets.io.ContentType.TEXT;
                gadgets.io.makeRequest(url, callback, params);
                

                서명된 승인

                opt_params[gadgets.io.RequestParameters.AUTHORIZATION]gadgets.io.AuthorizationType.SIGNED로 설정되면 컨테이너는 사용자의 ID를 대상 서버에 보증해야 합니다. 컨테이너는 이를 통해 다음을 수행합니다.

                1. 이름이 oauth, xoauth 또는 opensocial (대소문자를 구분하지 않음)로 시작하는 요청 매개변수를 삭제합니다.

                2. 요청 쿼리 문자열에 다음 매개변수를 추가합니다.

                  opensocial_viewer_id
                  선택사항입니다.
                  현재 뷰어의 ID로, 시청자 사람 객체의 getId() 값과 일치합니다.
                  오픈소셜_소유자_ID
                  필수.
                  현재 소유자의 ID로, 소유자 개인 객체의 getId() 값과 일치합니다.
                  오픈소셜_앱_URL
                  필수.
                  요청을 수행하는 애플리케이션의 URL입니다. 애플리케이션이 URL을 변경하는 경우 컨테이너는 여러 애플리케이션 URL을 단일 표준 애플리케이션 URL로 별칭을 지정할 수 있습니다.
                  opensocial_instance_id
                  선택사항입니다.
                  단일 컨테이너에서 동일한 애플리케이션의 여러 인스턴스를 구분하는 데 사용되는 불투명 식별자입니다. 컨테이너가 동일한 애플리케이션의 여러 인스턴스를 병용할 수 없는 경우 이 매개변수를 생략할 수 있습니다. opensocial_app_urlopensocial_instance_id의 조합은 컨테이너의 애플리케이션 인스턴스를 고유하게 식별합니다.
                  오픈소셜_앱_ID
                  선택사항입니다.
                  특정 컨테이너에 고유한 애플리케이션의 불투명 식별자입니다. opensocial-0.7 사양과의 하위 호환성을 유지하려는 컨테이너에는 이 매개변수가 포함될 수 있습니다.
                  xoauth_signature_publickey
                  선택사항입니다.
                  요청에 서명하는 데 사용된 공개 키의 불투명 식별자입니다. 요청에 서명하는 데 공개 키를 사용하지 않는 컨테이너 또는 컨테이너가 요청의 대상에 따라 다른 키 배포 방법을 정렬하는 경우 이 매개변수가 생략될 수 있습니다.
                3. OAuth 사양의 9항에 따라 결과 요청에 서명합니다.

              가젯s.io.authorizationType.SIGNED의 키 관리

              컨테이너가 공개 키를 사용하여 요청에 서명하는 경우 컨테이너는 자체 서명된 인증서 또는 잘 알려진 인증 기관이 서명한 인증서를 사용하도록 선택할 수 있습니다. 컨테이너가 HTTPS를 통해 OAuth 서명 키를 배포하지 않는 경우에는 잘 알려진 인증 기관에서 서명한 인증서를 사용해야 합니다.

              인증서의 commonName 속성은 컨테이너 서버의 호스트 이름과 일치해야 하며, 요청에 지정된 oauth_consumer_key 매개변수의 값과도 일치해야 합니다.

              컨테이너는 잘 알려진 위치에서 공개 키를 다운로드할 수 있도록 해야 합니다. https://container-hostname/opensocial/certificates/xoauth_signature_publickeyvalue 위치를 사용하는 것이 좋습니다.

              서명된 요청의 수신자는 요청의 서명이 올바른지, 요청의 타임스탬프가 합당한 기간 내에 있는지 확인해야 합니다. 현재 시간 전후의 5분 기간이 권장됩니다.

              서명된 요청의 수신자는 oauth_consumer_keyxoauth_signature_publickey 매개변수를 사용하여 컨테이너가 새 인증서를 배포할 때 자동으로 감지할 수 있습니다. 컨테이너가 잘 알려진 위치에 인증서를 배포하면 수신자는 새 인증서를 자동으로 다운로드할 수 있습니다. 새 인증서를 자동으로 다운로드하는 수신자는 결과 인증서를 캐시해야 합니다.

              컨테이너의 인증서가 https://container-hostname에서 다운로드되지 않은 경우 수신자는 인증서를 신뢰하기 전에 잘 알려진 인증 기관에서 서명했는지 확인해야 합니다.

              OAuth 승인

              opt_params[gadgets.io.RequestParameters.AUTHORIZATION]gadgets.io.AuthorizationType.OAUTH로 설정된 경우 컨테이너는 OAuth를 사용하여 요청에 지정된 리소스에 액세스할 수 있어야 합니다. 액세스 권한을 얻기 위해 사용자를 서비스 제공업체로 안내하여 가젯에서 사용자의 콘텐츠를 가져와야 할 수도 있습니다.

              추가 매개변수

              opt_params에 다음 추가 매개변수를 지정할 수 있습니다.

              가젯s.io.RequestParameters.OAUTH_SERVICE_NAME
              가젯이 XML 사양에서 OAuth 'Service' 요소를 참조하는 데 사용하는 닉네임입니다. 지정하지 않으면 기본값은 '&t'입니다.
              가젯s.io.RequestParameters.OAUTH_TOKEN_NAME
              가젯이 특정 리소스에 대한 액세스 권한을 부여하는 OAuth 토큰을 나타내는 데 사용하는 닉네임입니다. 지정하지 않으면 기본값은 ""입니다. 동일한 서비스 제공업체의 여러 리소스에 액세스할 수 있는 경우 가젯은 여러 토큰 이름을 사용할 수 있습니다. 예를 들어 연락처 목록 및 캘린더에 대한 액세스 권한이 있는 가젯은 토큰 목록 토큰으로 '연락처'를 사용하고 캘린더 토큰을 사용하려면 '캘린더' 연락처 이름을 사용합니다.
              가젯s.io.RequestParameters.OAUTH_REQUEST_TOKEN
              서비스 제공업체가 리소스에 대한 액세스가 사전 승인된 요청 토큰으로 자동으로 프로비저닝을 프로비저닝할 수 있습니다. 가젯은 이 토큰을 OAUTH_REQUEST_TOKEN 매개변수와 함께 사용할 수 있습니다. 이 매개변수는 선택사항입니다.
              가젯s.io.RequestParameters.OAUTH_REQUEST_TOKEN_SECRET
              사전 승인된 요청 토큰에 해당하는 보안 비밀입니다. 이 매개변수는 선택사항입니다.

              OAuth를 사용하는 경우 컨테이너는 가젯 대신 OAuth 프로토콜을 실행해야 합니다. 가젯이 이 서비스 제공업체에 사용할 소비자 키를 등록하지 않은 경우 컨테이너는 잘 알려진 인증서에 해당하는 기본 RSA 서명 키를 사용하여 요청에 서명하도록 선택할 수 있습니다. 컨테이너가 기본 소비자 키를 사용하는 경우 요청을 보내는 가젯이 식별되는 추가 OAuth 매개변수 xoauth_app_url이 포함됩니다.

              콜백 매개변수

              makeRequest() 콜백 매개변수에 makeRequest()가 반환하는 일반 값 외에도 여러 OAuth 관련 필드가 포함된 자바스크립트 객체가 전달됩니다.

              "oauthApprovalUrl"
              이 값이 지정된 경우 사용자는 외부 페이지를 방문하여 가젯의 데이터 액세스 요청을 승인해야 합니다. 팝업 창을 사용하여 사용자를 외부 페이지로 연결하는 것이 좋습니다. 사용자가 액세스를 승인하면 가젯이 makeRequest 호출을 반복하여 데이터를 검색할 수 있습니다.
              "oauthError"
              이 값을 지정하면 OAuth 관련 오류가 발생했음을 나타냅니다. 값은 프로그래매틱 방식으로 오류를 감지하는 데 사용할 수 있는 문자열 상수 세트 중 하나입니다. 상수는 opensocial-0.8의 경우 정의되지 않지만 구현자는 opensocial-0.9의 표준화에 유용한 상수 값 세트에 동의하려고 해야 합니다.
              "oauthErrorText"
              이 값을 지정하면 OAuth 관련 오류가 발생했음을 나타냅니다. 이 값은 가젯 개발자에게 디버깅 정보를 제공하는 데 사용할 수 있는 자유 형식 텍스트입니다.
                매개변수:
                  String url - 콘텐츠가 있는 URL
                  Function callback - 데이터를 가져온 후 URL의 데이터로 호출할 함수

                맨 위로

                정적 클래스 가젯.io.authorizationType

                RequestParameters에서 사용됩니다.

                필드 요약

                <static> object NONE
                승인하지 않았습니다.
                <static> object OAUTH
                컨테이너는 인증에 OAuth를 사용합니다.
                <static> object SIGNED
                컨테이너가 요청에 서명합니다.
                 

                필드 세부정보

                없음

                <static> object NONE
                  승인되지 않습니다.

                OAuth

                <static> object OAUTH
                  컨테이너에서 인증에 OAuth를 사용합니다.

                서명함

                <static> object SIGNED
                  컨테이너가 서명합니다.

                맨 위로

                정적 클래스 가젯.io.ContentType

                RequestParameters에서 사용됩니다.

                필드 요약

                <static> object DOM
                XML 객체를 가져오는 데 사용되는 DOM 객체를 반환합니다.
                <static> object FEED
                RSS 또는 Atom 피드의 JSON 표현을 반환합니다.
                <static> object JSON
                JSON 객체를 반환합니다.
                <static> object TEXT
                텍스트를 반환하며 HTML을 가져오는 데 사용됩니다.
                 

                필드 세부정보

                DOM

                <static> object DOM
                  XML 객체를 가져오는 데 사용되는 DOM 객체를 반환합니다.

                피드

                <static> object FEED
                  RSS 또는 Atom 피드의 JSON 표현을 반환합니다.

                JSON

                <static> object JSON
                  JSON 객체를 반환합니다.

                텍스트

                <static> object TEXT
                  HTML을 가져오는 데 사용되는 텍스트를 반환합니다.

                맨 위로

                정적 클래스 가젯.io.MethodType

                RequestParameters.Method 값을 정의합니다.

                필드 요약

                <static> object DELETE
                이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.
                <static> object GET
                기본 유형.
                <static> object HEAD
                이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.
                <static> object POST
                이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.
                <static> object PUT
                이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.
                 

                필드 세부정보

                삭제

                <static> object DELETE
                  이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.

                GET

                <static> object GET
                  기본 유형입니다.
                <static> object HEAD
                  이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.

                POST

                <static> object POST
                  이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.

                PUT

                <static> object PUT
                  이 메서드 유형에 대한 컨테이너 지원은 선택사항입니다.

                맨 위로

                정적 클래스 가젯.io.ProxyUrlRequestParameters

                gadgets.io.getProxyUrl() 메서드에서 사용됩니다.

                필드 요약

                <static> object REFRESH_INTERVAL
                콘텐츠 캐싱을 시도합니다.
                 

                필드 세부정보

                새로고침_간편

                <static> object REFRESH_INTERVAL
                  콘텐츠 캐싱을 사용해 봅니다. 새로고침 간격은 지정된 응답을 캐시하려는 시간(초)입니다. 기본적으로 HTTP 헤더가 적용됩니다. HTTP 헤더가 없는 경우 이 값은 기본적으로 3600 (1시간)으로 설정됩니다. POST_DATA가 있는 서명된 요청 및 객체는 일반적으로 캐시되지 않습니다.

                맨 위로

                정적 클래스 가젯.io.RequestParameters

                gadgets.io.makeRequest() 메서드에서 사용됩니다.

                필드 요약

                <static> object AUTHORIZATION
                콘텐츠를 가져올 때 사용할 인증 유형입니다. 기본값은 AuthorizationType.NONE입니다.
                <static> object CONTENT_TYPE
                URL에 있는 콘텐츠 유형입니다. 기본값은 ContentType.TEXT입니다.
                <static> object GET_SUMMARIES
                콘텐츠가 피드인 경우 피드의 요약을 가져올지 여부를 설정합니다. 기본값은 false입니다.
                <static> object HEADERS
                URL로 전송할 HTTP 헤더입니다. 기본값은 null입니다.
                <static> object METHOD
                URL에서 콘텐츠를 가져올 때 사용하는 메서드로, 기본값은 MethodType.GET입니다.
                <static> object NUM_ENTRIES
                콘텐츠가 피드인 경우 가져올 항목 수이며 기본값은 3입니다.
                <static> object POST_DATA
                POST 메서드를 사용하여 URL로 전송할 데이터입니다. 기본값은 null입니다.
                 

                필드 세부정보

                승인

                <static> object AUTHORIZATION
                  콘텐츠를 가져올 때 사용할 인증 유형입니다. 기본값은 AuthorizationType.NONE입니다. ApprovalType으로 지정됩니다.

                CONTENT_TYPE

                <static> object CONTENT_TYPE
                  URL에 상주하는 콘텐츠의 유형입니다. 기본값은 ContentType.TEXT입니다. ContentType으로 지정됩니다.

                GET_SUMMARIES

                <static> object GET_SUMMARIES
                  콘텐츠가 피드인 경우 피드의 요약을 가져올지 여부를 설정합니다. 기본값은 false입니다. Boolean으로 지정됩니다.

                헤더

                <static> object HEADERS
                  URL에 전송할 HTTP 헤더입니다. 기본값은 null입니다. Map.<String,String>으로 지정됩니다.

                방법

                <static> object METHOD
                  URL에서 콘텐츠를 가져올 때 사용하는 메서드로, 기본값은 MethodType.GET입니다. 유효한 값은 MethodType으로 지정됩니다.

                NUM_ENTRIES개

                <static> object NUM_ENTRIES
                  콘텐츠가 피드인 경우 가져올 항목 수, 기본값은 3입니다. Number으로 지정됩니다.

                POST_DATA

                <static> object POST_DATA
                  POST 메서드를 사용하여 URL로 전송할 데이터입니다. 기본값은 null입니다. String으로 지정됩니다.

                맨 위로

                정적 클래스 가젯.json

                JSON에서 객체를 변환하는 작업을 제공합니다.

                메소드 요약

                <static>  Object parse(text)
                JSON 문자열을 파싱하여 자바스크립트 값을 생성합니다.
                <static>  String stringify(v)
                자바스크립트 값을 JSON 문자열로 변환합니다.
                 

                메소드 세부정보

                파싱

                <static> Object parse(text)
                  JSON 문자열을 파싱하여 자바스크립트 값을 생성합니다.
                  매개변수:
                    String text - 객체로 변환할 문자열입니다. 일반적으로 이전 문자열화 호출의 결과입니다.
                  반환:
                    Object  전달된 텍스트에서 파싱된 객체입니다.

                문자열

                <static> String stringify(v)
                  자바스크립트 값을 JSON 문자열로 변환합니다.
                  매개변수:
                    Object v - 변환할 객체
                  반환:
                    String  JSON 해당

                맨 위로

                정적 클래스 가젯.pubsub

                메시지 채널 게시 및 구독 작업을 제공합니다.

                메소드 요약

                <static> publish(channelName, message)
                채널에 문자열 유형의 메시지를 게시합니다.
                <static> subscribe(channelName, callback)
                메시지 채널을 가젯으로 구독합니다.
                <static> unsubscribe(channelName)
                메시지 채널의 가젯 구독 취소
                 

                메소드 세부정보

                게시

                <static> publish(channelName, message)
                  채널에 문자열 유형 메시지를 게시합니다.
                  매개변수:
                    String channelName - 채널 이름
                    String message - 게시할 메시지

                구독/수신

                <static> subscribe(channelName, callback)
                  메시지 채널을 가젯으로 구독합니다.
                  매개변수:
                    String channelName - 채널 이름
                    Function callback - 채널 메시지로 호출될 함수

                unsubscribe

                <static> unsubscribe(channelName)
                  메시지 채널에서 가젯이 구독 취소됩니다.
                  매개변수:
                    String channelName - 채널 이름

                맨 위로

                정적 클래스 가젯.rpc

                가젯 간, 컨테이너 간 가젯, 가젯 간 통신에 대한 원격 절차 호출을 수행하는 작업을 제공합니다.

                메소드 요약

                <static> call(targetId, serviceName, callback, var_args)
                RPC 서비스를 호출합니다.
                <static> register(serviceName, handler)
                RPC 서비스를 등록합니다.
                <static> registerDefault(handler)
                기본 서비스 핸들러를 등록하여 알 수 없는 원격 절차 호출을 모두 처리합니다. 이 메서드는 기본적으로 자동으로 실패합니다.
                <static> unregister(serviceName)
                RPC 서비스를 등록 취소합니다.
                <static> unregisterDefault()
                기본 서비스 핸들러를 등록 취소합니다.
                 

                메소드 세부정보

                통화

                <static> call(targetId, serviceName, callback, var_args)
                  RPC 서비스를 호출합니다.
                  매개변수:
                    String targetId - RPC 서비스 제공업체의 ID, 상위 컨테이너를 호출하는 경우 비어 있음
                    String serviceName - RPC 요청의 반환 값을 처리하는 서비스 이름
                    Function, null callback - RPC 요청의 반환 값을 처리하기 위한 콜백 함수 (있는 경우)

                등록

                <static> register(serviceName, handler)
                  RPC 서비스를 등록합니다.
                  매개변수:
                    String serviceName - 등록할 서비스 이름
                    Function handler - 서비스 핸들러

                registerDefault

                <static> registerDefault(handler)
                  알 수 없는 모든 원격 절차 호출을 처리하도록 기본 서비스 핸들러를 등록합니다. 이 핸들러는 기본적으로 자동으로 실패합니다.
                  매개변수:
                    Function handler - 서비스 핸들러

                등록 취소

                <static> unregister(serviceName)
                  RPC 서비스를 등록 취소합니다.
                  매개변수:
                    String serviceName - 등록 취소할 서비스 이름

                기본 등록 취소

                <static> unregisterDefault()
                  기본 서비스 핸들러를 등록 취소합니다. 향후 알 수 없는 원격 절차 호출이 자동으로 실패합니다.

                맨 위로

                정적 클래스 가젯.skins

                현재 표시된 스킨에 관한 표시 정보를 가져오는 작업을 제공합니다.

                메소드 요약

                <static>  String getProperty(propertyKey)
                지정된 키에 매핑된 디스플레이 속성을 가져옵니다.
                 

                메소드 세부정보

                getProperty

                <static> String getProperty(propertyKey)
                  지정된 키에 매핑된 디스플레이 속성을 가져옵니다.
                  매개변수:
                  반환:
                    String  데이터

                맨 위로

                정적 클래스 가젯.skins.Property

                가젯 UI에서 가져와서 사용할 수 있는 모든 표시 값입니다. Gadgets.skins.getProperty() 메서드에 지원되는 키입니다.

                필드 요약

                <static> object ANCHOR_COLOR
                앵커 태그에서 사용해야 하는 색상입니다.
                <static> object BG_COLOR
                가젯 배경의 색상입니다.
                <static> object BG_IMAGE
                가젯의 배경에서 사용할 이미지입니다.
                <static> object FONT_COLOR
                기본 글꼴을 렌더링해야 하는 색상입니다.
                 

                필드 세부정보

                앵커_색상

                <static> object ANCHOR_COLOR
                  앵커 태그가 사용해야 하는 색상입니다.

                배경 색상

                <static> object BG_COLOR
                  가젯의 배경 색상입니다.

                배경 이미지

                <static> object BG_IMAGE
                  가젯의 배경에서 사용할 이미지입니다.

                글꼴 색상

                <static> object FONT_COLOR
                  기본 글꼴을 렌더링해야 하는 색상입니다.

                맨 위로

                정적 클래스 가젯.util

                범용 유틸리티 함수를 제공합니다.

                메소드 요약

                <static>  String escapeString(str)
                더 안전하게 만들기 위해 HTML 항목을 사용하여 입력을 이스케이프 처리합니다.
                <static>  Object getFeatureParameters(feature)
                이 특성의 매개변수 값을 반환합니다.
                <static>  Boolean hasFeature(feature)
                지정된 기능이 지원되는지 여부를 반환합니다.
                <static> registerOnLoadHandler(callback)
                가젯이 로드될 때 실행되는 함수인 onload 핸들러를 등록합니다.
                <static>  String unescapeString(str)
                역방향 EscString

                메소드 세부정보

                이스케이프 문자열

                <static> String escapeString(str)
                  입력 내용을 이스케이프 처리하여 HTML 항목을 더 안전하게 보호합니다. 다음 문자가 영향을 받습니다.
                  • 줄바꿈 (\n, 유니코드 코드 포인트 10)
                  • 캐리지 리턴(Crashlytics, 유니코드 13)
                  • 큰따옴표 (", 유니코드 34)
                  • ampersand (&, 유니코드 38)
                  • 작은따옴표 (', 유니코드 39)
                  • 왼쪽 꺾쇠괄호 (<, 유니코드 60)
                  • 오른쪽 꺾쇠괄호 (>, 유니코드 62)
                  • 백슬래시 (\, 유니코드 92)
                  • 줄 구분자 (유니코드 8232)
                  • 단락 구분자 (유니코드 8233)
                  매개변수:
                    String str - 이스케이프할 문자열
                  반환:
                    String  이스케이프된 문자열

                getFeatureParameters

                <static> Object getFeatureParameters(feature)
                  이 특성의 매개변수 값을 반환합니다. 가젯은 <Requires> 또는 <Optional> 요소의 <Param> 하위 요소를 사용하여 매개변수를 지정합니다.
                  매개변수:
                    String feature -
                  반환되는 매개변수:
                    Object  해당 특성의 매개변수 또는 null

                hasFeature

                <static> Boolean hasFeature(feature)
                  지정된 기능이 지원되는지 여부를 반환합니다.
                  매개변수:
                    String feature - 테스트할 기능
                  반환:
                    Boolean  기능이 지원되는 경우 True

                registerOnLoadHandler

                <static> registerOnLoadHandler(callback)
                  가젯이 로드될 때 실행되는 함수인 onload 핸들러를 등록합니다.
                  매개변수:
                    Function callback - 실행할 핸들러

                unEscString

                <static> String unescapeString(str)
                  역방향 EscString
                  매개변수:
                    String str - 이스케이프 해제할 문자열입니다.
                  반환:
                    String  이스케이프되지 않은 문자열

                맨 위로

                정적 클래스 가젯.views.

                뷰 처리 작업을 제공합니다.

                참고 항목: gadgets.views.View

                메소드 요약

                <static>  String bind(urlTemplate, environment)
                URL 템플릿을 전달된 환경의 변수와 바인딩하여 URL 문자열을 생성합니다.
                <static>  gadgets.views.View getCurrentView()
                현재 뷰를 반환합니다.
                <static>  Map.<String, String> getParams()
                이 뷰의 경우 이 가젯에 전달된 매개변수를 반환합니다.
                <static>  Map<gadgets.views.ViewType, String, gadgets.views.View> getSupportedViews()
                지원되는 모든 뷰의 지도를 반환합니다.
                <static> requestNavigateTo(view, opt_params, opt_ownerId)
                다른 보기로 이 가젯으로 이동하려고 시도합니다.
                 

                메소드 세부정보

                bind

                <static> String bind(urlTemplate, environment)
                  URL 템플릿을 전달된 환경의 변수와 바인딩하여 URL 문자열을 생성합니다.

                  참고 항목: View.getUrlTemplate()

                  매개변수:
                    urlTemplate - 컨테이너 보기의 URL 템플릿
                    environment - 이름이 지정된 문자열 집합(예: [OWNER | PATH | PARAMS | NAME])
                  반환:
                    String  URL 문자열

                getCurrentView

                <static> gadgets.views.View getCurrentView()
                  현재 뷰를 반환합니다.
                  반환:
                    gadgets.views.View  현재 뷰

                getParams

                <static> Map.<String, String> getParams()
                  이 뷰에 대해 이 가젯에 전달된 매개변수를 반환합니다. 모든 URL 매개변수가 포함되는 것은 아니며 가젯 가젯 조회로 전달된 매개변수만 포함됩니다.
                  반환:
                    Map.<String, String>  매개변수 맵

                getSupportedViews

                <static> Map<gadgets.views.ViewType, String, gadgets.views.View> getSupportedViews()
                  지원되는 모든 뷰의 지도를 반환합니다. 각 가젯 가젯 뷰를 이름으로 지정합니다.
                  반환:
                    Map<gadgets.views.ViewType, String, gadgets.views.View>  지원되는 모든 뷰. 이름 속성으로 키가 지정됩니다.

                요청 탐색

                <static> requestNavigateTo(view, opt_params, opt_ownerId)
                  다른 보기에서 이 가젯으로 이동하려고 합니다. 컨테이너가 매개변수를 지원하는 경우 선택적 매개변수를 새 뷰의 가젯에 전달합니다.
                  매개변수:
                    gadgets.views.View view - 이동하려는 보기
                    Map.<String, String> opt_params - 가젯이 탐색된 후 가젯에 전달할 매개변수입니다.
                    String opt_ownerId - 이동할 페이지의 소유자 ID입니다.
                }

                맨 위로

                가젯 가젯 보기.뷰

                모든 뷰 객체의 기본 인터페이스입니다.

                메소드 요약

                 String bind(environment)
                뷰의 URL 템플릿을 전달된 환경의 변수와 바인딩하여 URL 문자열을 생성합니다.
                 gadgets.views.ViewType, String getName()
                이 뷰의 이름을 반환합니다.
                 String getUrlTemplate()
                대체용 변수가 포함된 IETF 사양 초안을 준수하는 문자열 URI 템플릿을 반환합니다.
                 boolean isOnlyVisibleGadget()
                이 뷰에 가젯이 유일하게 표시되는 경우 true를 반환합니다.
                 

                메소드 세부정보

                bind

                String bind(environment)
                  뷰의 URL 템플릿을 전달된 환경의 변수와 바인딩하여 URL 문자열을 생성합니다.

                  참고 항목: getUrlTemplate()

                  매개변수:
                    environment - 이름이 지정된 문자열 세트(예: [OWNER | PATH | PARAMS | NAME])
                  반환:
                    String  URL 문자열

                getName

                gadgets.views.ViewType, String getName()
                  이 뷰의 이름을 반환합니다.
                  반환:
                    gadgets.views.ViewType, String  일반적으로 뷰 이름이며 일반적으로 가젯s.views.ViewType으로 지정됩니다.

                getUrlTemplate

                String getUrlTemplate()
                  IETF 사양 초안에 따라 대체 변수가 포함된 문자열 URI 템플릿을 반환합니다.

                  다음과 같은 4가지 변수가 지원됩니다.

                  이름
                  애플리케이션의 이름 또는 ID
                  소유자
                  페이지 소유자의 ID
                  경로
                  경로 단계의 배열
                  매개변수
                  연결 배열 또는 배열[param1,value1,param2,value2,...]

                  유효한 URL 템플릿 문자열은 다음과 같습니다.

                  http://container.com/{-list|/|name,owner,path}?{-join|&|params}
                  http://container.com/apps/{name}/{owner}{-prefix|/|path}{-opt|?os_|params}{-join|&os_|params} 
                  

                  다음은 몇 가지 매개변수입니다.

                  { 
                    name : 'Wilma',
                    owner : 'Betty',
                    path : ['dino','car'], 
                    params = { a : 'Barney', b : 'Fred'}
                  }

                  이러한 매개변수를 사용하면 두 개의 예시 URL 템플릿 문자열이 다음 URL로 변환됩니다.

                  http://container.com/Wilma/Betty/dino/car?a=Barney&b=Fred
                  http://container.com/apps/Wilma/Betty/dino/car?os_a=Barney&os_b=Fred
                  

                  참고 항목: bind()

                  반환:
                    String  이 뷰로 이동하는 URL을 구성하는 데 사용할 수 있는 템플릿

                isOnlyVisibleGadget

                boolean isOnlyVisibleGadget()
                  이 뷰에 가젯이 유일하게 표시되는 가젯인 경우 true를 반환합니다. 캔버스 페이지 또는 최대화 모드에서는 true일 가능성이 높으며, 프로필 페이지 또는 대시보드 모드에서는 false일 가능성이 큽니다.
                  반환:
                    boolean  가젯이 유일하게 표시되는 가젯인 경우 참, 그렇지 않은 경우 거짓

                맨 위로

                정적 클래스 가젯s.views.ViewType

                에서 사용됩니다.

                필드 요약

                <static> object CANVAS
                아주 큰 모드로 가젯이 표시되는 뷰
                <static> object HOME
                일반적으로 다른 가젯이 있는 페이지의 작은 영역에 가젯이 표시되는 뷰입니다.
                <static> object PREVIEW
                가젯의 데모 뷰입니다.
                <static> object PROFILE
                일반적으로 다른 가젯이 있는 페이지의 작은 영역에 가젯이 표시되는 뷰입니다.
                 

                필드 세부정보

                캐나다

                <static> object CANVAS
                  가젯이 매우 큰 모드로 표시되는 뷰입니다. 일반적으로 페이지의 주요 콘텐츠입니다. 뷰어는 소유자와 항상 동일하지는 않습니다.

                <static> object HOME
                  일반적으로 다른 가젯이 있는 페이지에 있는 작은 영역에 가젯이 표시되는 뷰 일반적으로 뷰어는 소유자와 동일합니다.

                미리보기

                <static> object PREVIEW
                  가젯의 데모 뷰 이 뷰에서 소유자와 뷰어를 알 수 없습니다.

                프로필

                <static> object PROFILE
                  일반적으로 다른 가젯이 있는 페이지에 있는 작은 영역에 가젯이 표시되는 뷰 뷰어는 소유자와 항상 동일한 것은 아닙니다.

                맨 위로

                정적 클래스 가젯.window

                가젯이 배치된 창에 대한 정보를 가져오고 수정하는 작업을 제공합니다.

                메소드 요약

                <static> adjustHeight(opt_height)
                가젯 높이를 조정합니다.
                <static>  Object getViewportDimensions()
                프레임의 내부 크기를 감지합니다.
                <static> setTitle(title)
                가젯 제목을 설정합니다.
                 

                메소드 세부정보

                높이 조절

                <static> adjustHeight(opt_height)
                  가젯 높이를 조정합니다.
                  매개변수:
                    Number opt_height - 원하는 높이(픽셀)입니다. 지정하지 않으면 가제트에 콘텐츠에 맞추려고 시도합니다.

                getViewportDimension

                <static> Object getViewportDimensions()
                  반환:
                    Object  너비 및 높이 속성이 있는 객체

                setTitle

                <static> setTitle(title)
                  가젯 제목을 설정합니다.
                  매개변수:
                    String title - 선호 제목

                맨 위로