가젯 문서 검색
죄송합니다. 이 문서는 더 이상 최신 버전이 아닙니다. 가장 최근 업데이트된 문서를 보시려면 영어 버전을 참고로 해주십시오. 불편을 끼쳐드려 죄송합니다.

시작하기

Google 가젯 API를 이용해 주셔서 감사합니다. 본 개발자 가이드에서는 Google 가젯 API를 사용해 가젯을 만드는 방법을 소개합니다. 가젯은 매우 쉽게 만들 수 있기 때문에 웹 프로그래밍을 이제 막 배우기 시작한 사용자에게는 안성맞춤이라 할 수 있습니다.

목차

  1. 'Hollo World'
  2. 가젯은 어떻게 구성되어 있습니까?
  3. 스크래치 패드: 시작하기
  4. 다음 작업

'Hello World'

Google 가젯 API를 가장 쉽게 익힐 수 있는 방법은 예제를 살펴보는 것입니다. 다음 가젯은 단순히 'Hello World'라는 메시지를 표시합니다. 

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

실제 가젯 사양은 여기에서 확인하시기 바랍니다.

예제를 실행하려면 다음 단계를 따르세요.

  1. iGoogle 사이트로 이동합니다.
  2. 가젯을 추가하려면 iGoogle 페이지가 있어야 합니다. iGoogle 페이지가 없는 경우 시작하기를 클릭하여 만들 수 있습니다. 그 다음 기존 Google 계정으로 로그인하거나 새 계정을 만듭니다.
  3. iGoogle 페이지를 만들고 나면 오른쪽 상단에서 콘텐츠 추가를 클릭하여 iGoogle 페이지에 가젯을 추가할 수 있습니다. 해당 버튼을 클릭하면 콘텐츠 디렉토리로 연결됩니다. 콘텐츠 디렉토리를 사용하여 가젯을 검색하고 iGoogle에 추가할 수 있습니다.
  4. 'iGoogle 콘텐츠 검색' 버튼 옆에 있는 URL로 추가를 클릭합니다.
  5. URL로 추가 텍스트 상자에 "hello.xml"을 입력한 후 추가를 클릭합니다.
  6. iGoogle로 돌아가기를 클릭하면 iGoogle에서 가젯이 추가되었음을 확인할 수 있습니다.

"hello.xml"이라는 텍스트는 http://www.google.com/ig/modules/hello.xml이라는 URL을 짧게 나타낸 것입니다. 해당 URL은 귀하 또는 귀하의 동료가 만드는 가젯이 공용 웹서버에 게시되는 한, URL로 추가 텍스트 상자를 통해 해당 가젯의 사양에 추가할 수 있습니다.

다음은 'Hello World'라는 메시지와 관련하여 주의해야 할 사항입니다.

가젯은 어떻게 구성되어 있습니까?

Google 가젯 API는 XML, HTML 및 JavaScript 같은 몇 개의 단순한 기본 항목들로 구성되며 HTML에 대한 기본사항만 이해하면 쉽게 만들 수 있습니다. 가젯을 만들기 위해 XML과 관련하여 필수적인 사항들을 여기에서 모두 찾아 볼 수 있습니다. 아직 JavaScript를 잘 모르는 경우여도 괜찮습니다. 하지만 나중에 보다 복잡한 가젯을 만들게 되면 아마도 JavaScript의 필요성을 인식하게 될 거라 생각합니다

XML - 범용 마크업 언어로서 인간과 컴퓨터가 모두 읽고 쓸 수 있는 방식으로 구조화된 데이터입니다.

XML은 가젯 사양을 작성하기 위해 사용하는 언어입니다. 가젯은 단순히 XML 파일로서 Google이 찾을 수 있도록 인터넷에 올린 것 뿐입니다. 가젯을 지정하는 XML 파일에는 해당 가젯을 처리하고 렌더링하는 방법에 대한 지침이 포함됩니다. XML 파일에는 가젯과 관련한 모든 데이터 및 코드를 포함할 수 있으며 나머지 요소를 찾을 수 있는 참조위치(URL)도 포함할 수 있습니다.

HTML - 인터넷 페이지의 형식을 지정하기 위한 마크업 언어입니다. 가젯의 정적 콘텐츠는 대개 HTML로 작성됩니다. HTML은 XML과 유사하지만 체계적인 데이터를 설명하기 위해서가 아니라 웹 문서의 형식을 지정하기 위해 사용됩니다.

JavaScript - 가젯에 동적 동작을 추가하기 위해 사용하는 스크립트 언어입니다.

참고: 가젯의 옛 명칭이 모듈이었기 때문에 API 전반에 걸쳐 '모듈'이라는 단어가 자주 사용됩니다.

스크래치 패드: 시작하기

가젯을 처음 만들 때 가장 쉽게 만들 수 있는 방법은 스크래치 패드를 사용하는 것입니다. 스크래치 패드를 사용하면 가젯 사양을 수정할 수 있으며 개발자 가이드에서 벗어나지 않고도 미리보기 기능을 통해 변경사항이 적용된 모습을 확인할 수 있습니다. 스크래치 패드를 사용하는 방법에는 여러 가지가 있습니다.

스크래치 패드에는 'Hello World' 가젯의 사양이 기본으로 포함됩니다. 'Hello World'의 제목 및 메시지 역시 다음과 같이 수정할 수 있습니다. 

<?xml version="1.0" encoding="UTF-8" ?> 
<Module>
  <ModulePrefs title="My first gadget" /> 
  <Content type="html"> 
  <![CDATA[ 
    <B>Welcome to my first gadget!</B> 
  ]]> 
  </Content> 
</Module>

스크래치 패드에서 변경 결과를 확인하려면 미리보기를 클릭하세요. 페이지를 새로 고치면 원본 'Hello World' 가젯 사양이 스크래치 패드에 다시 나타납니다. 스크래치 패드 아래에는 확인 및 수정이 가능한 기타 샘플 가젯 링크가 표시됩니다.

'미리보기'를 클릭하면 변경사항을 확인하고 쉽게 수정할 수 있습니다.


다음 작업

'시작하기' 안내서를 통해 가젯과 관련된 정보를 확인하고 스크래치 패드 관련 작업을 수행할 수 있습니다. 다음 단계로 넘어갈 준비가 되면 나만의 가젯 만들기로 이동하세요. 그 다음 개발 기본사항으로 이동하거나 설명서 홈페이지로 돌아가서 각 섹션 및 주제에 대한 개요를 확인하세요.

 

위로 이동

업데이트 날짜: