이 페이지에서는 리소스 지향 설계 및 리소스 이름 개발자 가이드를 숙지하고 있다고 가정하며 Search Ads 360 Reporting API의 구체적인 구현 세부정보를 통해 이를 보완합니다.
리소스 중심 디자인
일반적으로 Search Ads 360 Reporting API는 개별적으로 주소를 지정할 수 있는 리소스 (API의 명사)의 컬렉션으로 모델링된 리소스 중심 설계를 따릅니다.
리소스는 리소스 이름으로 참조되며 적은 수의 메서드 집합 (동사 또는 작업으로도 알려짐)을 사용하여 조작됩니다.
이러한 리소스 이름과 메서드는 특정 API 버전 접두사와 함께 REST 인터페이스의 URL을 구성합니다.
예를 들어 아래 URL은 다음 표에 따라 다음과 같은 개별 구성요소로 분류할 수 있습니다.
특정 버전의 API (예: v0)는 공통 API 버전 접두사를 공유합니다. 리소스 이름과 메서드를 함께 사용하면 호출되는 API 서비스를 식별할 수 있습니다.
Search Ads 360 Reporting API는 list 및 get와 같은 표준 REST 메서드를 사용하는 대부분의 기존 REST API와 달리 맞춤 메서드를 많이 사용합니다. Search Ads 360 Reporting API에는 search 및 searchStream라는 두 가지 맞춤 메서드가 포함되어 있습니다.
다음 페이지에서는 Search Ads 360 Reporting API의 리소스 이름, 서비스 메서드, JSON 이름 지정 규칙에 대해 자세히 알아보고 이러한 항목이 함께 사용되어 REST 인터페이스 엔드포인트를 정의하는 방법을 설명합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-11-21(UTC)"],[[["The Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated."],["The API primarily uses custom methods like `search` and `searchStream` instead of traditional REST methods."],["API endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation."],["The guide's examples demonstrate API calls using HTTP, with further instructions available for using the `curl` command-line utility."],["Developers should be familiar with Resource Oriented Design and Resource Names before using this API."]]],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]
