시작하기: gadgets.* API

가젯 API에 오신 것을 환영합니다.

이 개발자 가이드는 가젯 자바스크립트 API의 gadgets.* 버전을 기반으로 합니다. 가젯 API가 gadgets.* 자바스크립트 네임스페이스로 "네임스페이스가 변경"되어 프로그래밍과 지원을 위해 더 향상된 API를 제공합니다. gadgets.* API에 대한 자세한 내용은 여기 문서를 참조하시기 바랍니다. gadgets.* API는 레거시 가젯 API와 공통점이 많지만 중요한 차이점도 있습니다.

현재 일부 컨테이너(컨테이너는 가젯을 실행하는 사이트 또는 응용프로그램임)만 gadgets.* API를 지원합니다. gadgets.* API를 지원하는 컨테이너 목록을 보려면 오픈소셜 컨테이너 목록을 참조하시기 바랍니다. 일부 오래된 컨테이너는 레거시 가젯 API만 지원하므로 지원되는 API를 보려면 특정 컨테이너에 대한 문서를 반드시 확인해 보시기 바랍니다. 다양한 유형의 가젯과 가젯 실행 환경에 대한 자세한 내용은 가젯 API 개요를 참조하시기 바랍니다.

모든 컨테이너는 gadgets.* API 지원 여부에 상관없이 레거시 API를 지원합니다. 하지만 gadgets.* API에서는 레거시 API에 없는 새로운 기능을 많이 제공하므로 가능하면 사용해 보시기 바랍니다.

이 개발자 가이드는 가젯 API를 사용하여 가젯을 작성하려는 사람들을 위해 만들어졌습니다. 가젯은 작성하기가 매우 쉬우므로 웹 프로그래밍에 대해 막 배우기 시작한 사람들에게 좋은 출발점이 될 수 있습니다.

목차

  1. "Hello, World"
  2. 가젯의 구성요소
  3. 다음 단계

"Hello, World"

가장 간단한 가젯은 단 몇 줄의 코드입니다. 이 가젯은 "Hello, world!"라는 메시지를 표시합니다.

<?xml version="1.0" encoding="UTF-8" ?> 
<Module>
<ModulePrefs title="hello world example" />
<Content type="html">
<![CDATA[ Hello, world! ]]> </Content>
</Module>

"Hello World" 예에 대해서 다음 몇 가지에 주목하시기 바랍니다.

  • 가젯이 XML로 지정되어 있습니다. 첫 번째 행은 XML 파일을 시작하는 표준 방법입니다. 파일의 첫 번째 행은 위와 같이 작성되어야 합니다.
  • <Module> 태그는 XML 파일에 가젯이 포함되어 있음을 나타냅니다.
  • <ModulePrefs> 태그에는 제목, 설명, 작성자 및 기타 선택사항 기능과 같은 가젯 관련 정보가 들어 있습니다.
  • <Content type="html"> 행은 가젯의 콘텐츠 유형이 HTML임을 나타냅니다.
  • <![CDATA[ ...insert HTML here... ]]>는 가젯의 콘텐츠 유형이 html일 때 HTML을 둘러싸는 데 사용되며 CDATA 섹션 내의 텍스트를 XML로 처리하지 않도록 가젯 파서에 알립니다. CDATA 섹션에는 보통 HTML과 자바스크립트가 포함되어 있습니다.
  • </Content>는 콘텐츠 섹션의 끝을 나타냅니다.
  • </Module>은 가젯 정의의 끝을 나타냅니다.

가젯의 구성요소

가젯 API는 XML, HTML 및 자바스크립트라는 몇 가지 간단한 요소로 구성됩니다. HTML에 대한 기본적인 이해만 있으면 시작할 수 있습니다. 가젯 작성을 위해 XML에 대해 알아야 할 사항은 모두 이 문서에서 알려드릴 것입니다. 나중에 좀 더 정교한 가젯을 작성하게 되면 아직 자바스크립트에 익숙하지 않을 경우 약간의 자바스크립트를 배워야 할 수도 있습니다.

XML은 일반 목적의 마크업 언어로서 인간과 컴퓨터가 모두 읽고 쓸 수 있는 방식으로 구조화된 데이터를 설명합니다.

XML은 가젯 명세를 작성하는 데 사용하는 언어입니다. 가젯은 Google이 찾을 수 있는 인터넷 상의 어딘가에 위치한 XML 파일일 뿐입니다. 가젯을 지정하는 XML 파일에는 가젯을 처리하고 렌더링하는 방법에 대한 지시사항이 들어 있습니다. XML 파일은 가젯에 대한 모든 데이터와 코드를 포함하거나 나머지 요소를 찾을 수 있는 참조(URL)를 포함할 수도 있습니다.

HTML은 인터넷에 있는 페이지의 형식을 지정하는 데 사용되는 마크업 언어입니다. 가젯의 정적 콘텐츠는 보통 HTML로 작성됩니다. HTML은 XML과 비슷해 보이지만 구조화된 데이터를 설명하기보다 웹 문서의 형식을 지정하는 데 사용됩니다.

자바스크립트는 동적 동작을 가젯에 추가하는 데 사용할 수 있는 스크립팅 언어입니다.

다음 단계

소셜 가젯을 실행하는 모든 컨테이너에는 약간씩 다른 특성들이 있습니다. 소셜 가젯 개발을 실습할 수 있는 곳을 몇 군데 소개하면 다음과 같습니다.

더 일반적인 가젯 프로그래밍 정보를 보려면 나만의 가젯 작성으로 이동하시기 바랍니다. 거기에서 개발의 기초로 이동하거나 문서 홈 페이지로 돌아가서 섹션 및 주제에 대한 개요를 볼 수 있습니다.

맨위로