참조 가이드

이 문서에서는 Google Sites Data API의 원시 프로토콜 (XML 및 HTTP)에 대한 자세한 참조 문서를 제공합니다.

이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에서 제공하는 링크를 참조하세요.

시청자

이 문서는 Google Sites와 상호작용할 수 있는 클라이언트 애플리케이션을 개발하려는 프로그래머를 대상으로 합니다.

이 문서는 참조 프로토콜로, 프로토콜 가이드에 제시된 개념과 Google Data API 프로토콜에 대한 일반적인 개념을 이해하고 있다고 가정합니다.

Google Sites 피드 유형

Google Sites Data API는 다음 유형의 피드를 제공합니다.

활동 피드

활동 피드는 사이트 내 모든 활동에 대한 설명을 포함하는 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]

domainName는 'site' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName/)에 표시되는 사이트 이름입니다.

이 피드에 대한 모든 요청은 인증되어야 합니다.

지원되는 요청 유형: GET

콘텐츠 피드

콘텐츠 피드는 현재 수정 가능한 사이트 콘텐츠를 포함하는 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]

domainName는 'site' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.

이 피드에 대한 요청은 사이트 (게시) 설정에 따라 인증이 필요할 수도 있고 필요하지 않을 수도 있습니다.

지원되는 요청 유형: GET, POST, PUT, DELETE

표준 Data API 쿼리 매개변수 외에도 Sites Data API는 콘텐츠 피드를 사용하여 GET 요청을 실행하는 다음과 같은 선택적 매개변수를 허용합니다.

매개변수 설명 유형 참고
ancestor 지정된 상위 항목이 있는 항목만 요청합니다. 문자열 원하는 상위 항목의 ID를 입력합니다. 예: 0123456789. 상위 항목이 상위 요소로 지정된 모든 항목, 상위 요소의 상위 항목 등이 포함된 모든 항목을 반환합니다.
include-deleted 삭제된 항목을 포함할지 여부를 지정합니다. 불리언 가능한 값은 true 또는 false입니다. 기본값은 false입니다.
include-draft 임시 항목을 포함할지 여부를 지정합니다. 불리언 가능한 값은 true 또는 false입니다. 기본값은 false입니다. 초안을 보려면 초안의 소유자 또는 작성자여야 합니다.
kind 반환할 콘텐츠 항목의 종류를 지정합니다. Google Sites 내 페이지 유형을 따릅니다. 쉼표로 구분된 문자열 목록 가능한 값은 announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template입니다.
parent 지정된 상위 항목이 있는 항목만 요청합니다. 문자열 상위 항목의 ID를 입력합니다. 예: 0123456789.
path 특정 페이지 계층 구조의 콘텐츠 요청 문자열 콘텐츠를 가져올 사이트 내 하위 페이지의 경로입니다. 예: path=/path/to/page.

버전 피드

버전 피드는 사이트 콘텐츠의 이전 버전을 포함하는 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]

domainName는 'site' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.

이 피드에 대한 모든 요청은 인증되어야 합니다.

지원되는 요청 유형: GET

사이트 피드

사이트 피드를 사용하여 사용자가 소유하거나 보기 권한이 있는 Google Sites를 나열할 수 있습니다. 또한 새 사이트를 만들거나, 사이트를 복사하거나, 기존 사이트의 이름을 수정하는 데 사용할 수도 있습니다.

Sites 등록정보의 피드 URI는 다음과 같습니다.

https://sites.google.com/feeds/site/domainName/[siteName]

domainName는 'site' 또는 G Suite 도메인입니다.

이 피드에 대한 모든 요청은 인증되어야 합니다.

지원되는 요청 유형: GET, POST, PUT

사이트 피드는 사이트 나열에 대해 GET 요청을 실행할 때 다음 (선택사항) 매개변수를 지원합니다.

매개변수 설명 유형 참고
include-all-sites G Suite 도메인에서 사용자가 볼 수 있는 모든 사이트를 나열합니다. 불리언 이 매개변수는 G Suite 도메인의 사이트를 나열할 때만 적용됩니다. 가능한 값은 true 또는 false입니다. 기본값은 false입니다.
with-mappings 사이트 항목의 웹 주소 매핑이 포함됩니다. 불리언 가능한 값은 true 또는 false입니다. 기본값은 false입니다.

ACL 피드

ACL 피드를 사용하여 Google 사이트의 공유 권한 (ACL)을 나열하거나 수정할 수 있습니다.

Sites 등록정보의 피드 URI는 다음과 같습니다.

https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]

domainName는 'site' 또는 G Suite 도메인입니다.

이 피드에 대한 모든 요청은 인증되어야 합니다.

지원되는 요청 유형: GET, POST, PUT, DELETE

Google Sites 쿼리 매개변수 참조

Google Data API 프로토콜에서 지원되는 쿼리 매개변수:

  • max-results
  • published-max(콘텐츠 피드만)
  • published-min (콘텐츠 피드만)
  • start-index
  • updated-max
  • updated-min
  • q (전체 텍스트 쿼리)

해당 피드 관련 매개변수 목록은 위의 각 피드를 참조하세요.

맨 위로