이 페이지에서는 API를 사용하여 일반적인 작업을 수행하는 방법을 자세히 설명합니다.
사용자 만들기
UserService는 생성할 수 있는 관리자 권한이 있는 사용자는 네트워크에 직접 연결할 수 있습니다. 개발자라면 누구나 이 작업을 수행할 수 있는 신규 사용자가 먼저 가입하도록 해야 합니다 예를 들어, 관리자 자격으로 모든 API 호출을 수행하는 대신 (기본 설정) 이메일 주소에 대한 설명) 실제 워크플로를 테스트할 영업 담당자, 애드 마스터 또는 광고주
- 새 Gmail 주소(예:
my.name.salesperson@gmail.com)를 만듭니다. 이와 달리 Gmail이 아닌 기존 주소를 새 이메일 주소로 등록 Google 계정에 로그인합니다. - 새 주소와 선택된
Role로createUsers를 호출합니다. - 액세스 토큰을 생성하려면 OAuth 2.0을 사용하여 새 사용자로 인증할 수 있습니다.
루트 AdUnit 가져오기
하위 노드를 추가할 수 있는 최상위 AdUnit와 계층 구조의 허용되는 깊이는 모두 계정 유형 (Small Business 또는 Premium)에 따라 다릅니다. 하위 노드의 수정을 지원하는 최상위 AdUnit를 유효 루트 AdUnit라고 합니다.
유효 루트를 가져오려면 NetworkService.getCurrentNetwork()를 호출하고 반환된 Network 객체에서 effectiveRootAdUnitId 필드를 확인합니다.
참고: 계정 유형에 따라 지원되는 계층 구조 패턴이 다릅니다.
객체 쿼리
getObjectsByStatement() 메서드를 사용하여 검색 기준으로 객체를 검색합니다.
많은 서비스에서 노출됩니다. 여기서 Object는 특정 객체 유형입니다. 이
메서드는 PQL 쿼리를 사용합니다. PQL 쿼리는
검색할 필드 (필드 이름이 객체의 속성에 매핑되는 위치), 정렬,
검색 결과를 제한하고 상쇄할 수 있습니다. PQL 참조
가이드: PQL에 대해 자세히 알아보고 어떤 객체 필드를 사용할 수 있는지 알아보세요.
필터를 적용합니다.
주문 만들기
주문을 만들려면 Order 객체를 만들고 광고주를 설정하기만 하면 됩니다.
적절한 사용자에게 고유한 이름을 할당하고
그리고 createOrders()를 호출합니다. 결과에는 새로 만든 Order,
오류가 있을 수 있습니다.
예
주문 생성을 위한 자바 코드 예를 참고하세요.
광고 항목 만들기
새 광고 항목을 만드는 단계는 다음과 같습니다.
- 새
Order객체를 만들거나 기존 객체를 사용합니다. - 새
LineItem객체를 만들고 순환게재 유형, 광고 소재 크기 배열, 시작일, 종료일, 기타 속성을 설정할 수 있습니다. - 새
InventoryTargeting객체를 만들고 타겟팅하거나 제외할Placement또는AdUnit객체를 지정합니다. InventoryTargeting객체를 새Targeting객체 내에 래핑하고LineItem의 타겟팅 속성에 추가합니다.- 새 객체로 lineitem 서비스 메서드
createLineItems()를 호출하고 결과를 검토하여 객체가 생성되었는지 확인합니다.
예
광고 항목을 생성하기 위한 자바 코드의 예를 참조하세요.
광고 소재 만들기
광고 소재 유형이 다르면 지원되는 구성요소도 다릅니다(예: 이미지
광고 소재는 이미지의 단일 소스 파일을 지원합니다. 플래시 광고 소재는
두 개의 기본 자산 파일: 플래시 파일과 백업 이미지 파일(플래시가 존재하는 경우)
파일을 게재할 수 없습니다. 타사 사이트에 호스팅된 광고 소재의 경우
제3자 서버의 파일을 참조하는 HTML 스니펫만 반환합니다. 다음을 확인하세요.
순서대로 업로드해야 하는 애셋을 알 수 있는 특정 Creative 서브클래스
광고 소재를 만듭니다.
예
이미지 광고 소재를 만들기 위한 자바 코드의 예를 참조하세요.
기존 객체 수정
기존 객체를 수정하려면 getObjectsByStatement()를 호출하여 객체를 쿼리합니다.
반환된 객체의 값을 업데이트한 다음 updateObjects()를 호출합니다.
참고: 업데이트된 객체는 기존 객체를 완전히 대체하므로 보내는 객체에서 속성 값을 설정하지 않으면 저장된 객체는 이전 값이 아닌 해당 속성의 기본값을 가져옵니다.
객체 상태 변경
performObjectAction() 메서드를 호출하여 객체 상태가 변경됨
서비스에 의해 노출됩니다 이 메서드는 다음과 같은 두 개의 매개변수를 사용합니다.
- 실행하려는 작업을 설명하는 작업 객체의 인스턴스입니다. 대상
인스턴스, 주문 서비스는
ApproveOrders,PauseOrders, 및ArchiveOrders모든 작업 객체는 기본 작업에서 파생됨 클래스에 적합한 API를 제공합니다. - 변경할 객체를 설명하는 PQL 쿼리 변경할 수 있습니다. 적절한 PQL을 지정하여 한 번에 하나 이상의 객체의 상태 구문
광고 태그 생성
API를 사용하여 광고 태그를 생성할 수 없습니다. Google Ad Manager 웹사이트를 사용해야 합니다. 자세한 내용은 태그 지정 고객센터 섹션에서 자세히 알아보세요.
예시 더보기
클라이언트 라이브러리 샘플 코드, 사용할 수 있습니다. 자세한 내용은 클라이언트 라이브러리 및 예시 코드 페이지를 참조하세요.