이 문서에서는 Google Sites 데이터 API의 원시 프로토콜 (XML 및 HTTP)에 대한 자세한 참조 문서를 제공합니다.
이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 참조하세요.
잠재고객
이 문서는 Google 사이트 도구와 상호작용할 수 있는 클라이언트 애플리케이션을 작성하려는 프로그래머를 위해 작성되었습니다.
참조 문서입니다. 프로토콜 가이드에 제시된 개념과 Google 데이터 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
Sites Data API에서는 표준 데이터 API 쿼리 매개변수 외에도 다음과 같은 선택적 매개변수를 사용할 수 있습니다.
콘텐츠 피드를 사용하여 GET 요청 실행:
| 매개변수 | 설명 | 유형 | 참고 |
|---|---|---|---|
ancestor |
지정된 상위 항목이 있는 항목만 요청합니다. | 문자열 | 원하는 상위 항목의 ID를 제공합니다. 예: 0123456789 지정된 상위 항목을 상위 항목, 상위 항목의 상위 항목 등으로 갖는 모든 항목을 반환합니다. |
include-deleted |
삭제된 항목을 포함할지 여부를 지정합니다. | 부울 | 가능한 값은 true 또는 false입니다. 기본값은 false입니다. |
include-draft |
초안 항목을 포함할지 여부를 지정합니다. | 부울 | 가능한 값은 true 또는 false입니다. 기본값은 false입니다. 소유자 또는 작성자여야 합니다.
확인할 수 있습니다 |
kind |
반환할 콘텐츠 항목의 종류를 지정합니다. Google 사이트 도구 내의 페이지 유형을 따릅니다. | 쉼표로 구분된 문자열 목록 | 가능한 값은 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(전체 텍스트 쿼리)
해당 피드와 관련된 매개변수 목록은 위의 각 피드를 참조하세요.