안내 가이드

이 페이지에서는 API를 사용하여 일반적인 작업을 수행하는 방법을 자세히 설명합니다.

사용자 만들기

UserService를 사용하면 관리자 권한이 있는 사용자가 네트워크에서 직접 사용자를 생성할 수 있습니다. 개발자라면 누구나 신규 사용자가 로그인하지 않아도 가입할 수 있습니다. 예를 들어 API를 처음 사용하는 경우 관리자 (이메일 주소의 기본값)로서 모든 API 호출을 수행하는 대신 영업 담당자, 애드 마스터, 광고주와 같은 역할을 가진 몇 명의 사용자를 만들어 실제 워크플로를 테스트할 수 있습니다.

  1. my.name.dfp.salesperson@gmail.com 등의 새 Gmail 주소를 만듭니다. 또는 Gmail이 아닌 기존 주소를 새 Google 계정으로 등록합니다.
  2. 새 주소 및 선택한 Role를 사용하여 createUsers를 호출합니다.
  3. 액세스 토큰을 생성하는 데 OAuth 2.0을 사용하여 새 사용자로 인증할 수 있습니다.

루트 AdUnit 가져오기

하위 노드를 추가할 수 있는 최상위 AdUnit와 허용되는 계층 구조는 모두 계정 유형 (Small Business 또는 Premium)에 따라 다릅니다. 하위 노드 수정을 지원하는 최상위 AdUnit를 유효 루트 AdUnit라고 합니다.

유효 루트를 검색하려면 NetworkService.getCurrentNetwork()를 호출하고 반환된 Network 객체의 effectiveRootAdUnitId 필드를 검사합니다.

참고: 계정 유형에 따라 지원되는 계층 구조 패턴이 다릅니다.

객체 쿼리

여러 서비스에서 노출되는 getObjectsByStatement() 메서드를 사용하여 검색 기준으로 객체를 검색합니다. 여기서 Object는 특정 객체 유형입니다. 이 메서드는 검색할 필드 (필드 이름이 객체의 속성에 매핑되는 위치)를 지정하고 검색 결과를 정렬, 제한, 오프셋한다는 점에서 SQL 쿼리와 유사한 PQL 쿼리를 사용합니다. PQL 가이드에서 PQL에 대해 자세히 알아보고 필터링할 수 있는 객체 필드를 알아보세요.

주문 만들기

주문을 생성하려면 Order 객체를 만들고 광고주, 영업 담당자, 애드 마스터 ID를 적절한 사용자에게 설정하고, 고유한 이름을 할당하고, createOrders()를 호출하면 됩니다. 결과에는 새로 생성된 Order 또는 오류가 포함됩니다.

예

주문을 만들기 위한 자바 코드 예를 참고하세요.

광고 항목 만들기

새 광고 항목을 만드는 단계는 다음과 같습니다.

  1. 새 Order 객체를 만들거나 기존 객체를 사용합니다.
  2. 새 LineItem 객체를 만들고 순환게재 유형, 광고 소재 크기 배열, 시작일 및 종료일 및 기타 속성을 설정합니다.
  3. 새 InventoryTargeting 객체를 만들고 타겟팅하거나 제외할 Placement 또는 AdUnit 객체를 지정합니다.
  4. InventoryTargeting 객체를 새 Targeting 객체 내에 래핑하여 LineItem의 타겟팅 속성에 할당합니다.
  5. 새 객체로 광고 항목 서비스 메서드 createLineItems()를 호출하고 결과를 검토하여 객체가 생성되었는지 확인합니다.

예

광고 항목 생성을 위한 자바 코드 예를 참조하세요.

광고 소재 만들기

광고 소재 유형에 따라 지원되는 구성요소가 다릅니다. 예를 들어 이미지 광고 소재는 이미지에 대해 단일 소스 파일을 지원하고, 플래시 광고 소재는 플래시 파일과 플래시 파일을 게재할 수 없는 경우 백업 이미지 파일이라는 두 가지 기본 애셋 파일을 지원합니다. 제3자 사이트에서 호스팅되는 광고 소재의 경우, 제3자 서버의 파일을 참조하는 HTML 스니펫만 업로드합니다. 광고 소재를 만들기 위해 업로드해야 하는 애셋을 알아보려면 특정 Creative 서브클래스를 참고하세요.

예

이미지 광고 소재를 만들기 위한 자바 코드 예를 참조하세요.

기존 객체 수정

기존 객체를 수정하려면 getObjectsByStatement()를 호출하여 객체를 쿼리하고 반환된 객체의 값을 업데이트한 다음 updateObjects()를 호출합니다.

참고: 업데이트된 객체는 기존 객체를 완전히 대체하므로 전송하는 객체에 속성 값을 설정하지 않으면 저장된 객체는 이전 값이 아닌 해당 속성의 기본값을 가져옵니다.

객체 상태 변경하기

서비스에서 노출된 performObjectAction() 메서드를 호출하여 객체 상태를 변경합니다. 이 메서드에는 두 가지 매개변수가 사용됩니다.

  • 실행할 작업을 설명하는 작업 객체의 인스턴스입니다. 예를 들어 주문 서비스는 ApproveOrders, PauseOrders, ArchiveOrders를 비롯한 여러 작업을 노출합니다. 작업 객체는 모두 서비스에 적합한 기본 작업 클래스에서 가져옵니다.
  • 변경할 객체를 설명하는 PQL 쿼리 적절한 PQL 문을 지정하여 한 번에 하나 이상의 객체 상태를 변경할 수 있습니다.

광고 태그 생성

API를 사용하여 광고 태그를 생성할 수 없으며 Google Ad Manager 웹사이트를 사용해야 합니다. 자세한 내용은 태그 지정 고객센터 섹션을 참고하세요.

예시 더보기

다양한 프로그래밍 언어의 클라이언트 라이브러리 샘플 코드에서 더 많은 예를 확인할 수 있습니다. 사용 중인 프로그래밍 언어의 예제에 대한 링크는 클라이언트 라이브러리 및 예제 코드 페이지를 참조하세요.