이 문서에서는 Google Sites Data API의 원시 프로토콜(XML 및 HTTP)에 관한 자세한 참조 문서를 제공합니다.
이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 참고하세요.
잠재고객
이 문서는 Google 사이트 도구와 상호작용할 수 있는 클라이언트 애플리케이션을 작성하려는 프로그래머를 위해 작성되었습니다.
참고 문서이며 프로토콜 가이드에 설명된 개념과 Google Data API 프로토콜의 일반적인 개념을 이해하고 있다고 가정합니다.
Google Sites 피드 유형
Google Sites Data API는 다음 유형의 피드를 제공합니다.
활동 피드
활동 피드는 사이트 내의 모든 활동에 관한 설명이 포함된 피드입니다.
특정 도메인 내 사이트의 이 피드의 GET URI는 다음과 같습니다.
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName은 '사이트' 또는 G Suite 도메인입니다.
siteName는 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName/)에 표시되는 사이트 이름입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET
콘텐츠 피드
콘텐츠 피드는 수정 가능한 현재 사이트 콘텐츠가 포함된 피드입니다.
특정 도메인 내 사이트의 이 피드의 GET URI는 다음과 같습니다.
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName은 '사이트' 또는 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은 '사이트' 또는 G Suite 도메인입니다.
siteName는 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET
사이트 피드
사이트 피드는 사용자가 소유하거나 보기 권한이 있는 Google Sites를 나열하는 데 사용할 수 있습니다. 새 사이트를 만들거나, 사이트를 복사하거나, 기존 사이트의 이름을 수정하는 데 사용할 수도 있습니다.
사이트 등록정보의 피드 URI는 다음과 같습니다.
https://sites.google.com/feeds/site/domainName/[siteName]
domainName는 '사이트' 또는 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)을 나열하거나 수정할 수 있습니다.
사이트 목록의 피드 URI는 다음과 같습니다.
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName는 '사이트' 또는 G Suite 도메인입니다.
이 피드에 대한 모든 요청은 인증을 받아야 합니다.
지원되는 요청 유형: GET, POST, PUT, DELETE
Google Sites 쿼리 매개변수 참조
Google Data API 프로토콜에서 지원되는 쿼리 매개변수:
max-resultspublished-max(콘텐츠 피드만 해당)published-min(콘텐츠 피드만 해당)start-indexupdated-maxupdated-minq(전체 텍스트 쿼리)
해당 피드에 관한 매개변수 목록은 위의 각 피드를 참고하세요.