특정 달에 광고주에 게시된 인보이스를 나열합니다.
'파트너' 인보이스 수준의 결제 프로필에서 생성된 인보이스는 이 방법으로 검색할 수 없습니다.
HTTP 요청
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/invoices
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
advertiserId |
필수 항목입니다. 인보이스를 나열할 광고주의 ID입니다. |
쿼리 매개변수
매개변수 | |
---|---|
issueMonth |
인보이스를 나열할 월입니다. 설정하지 않으면 이전 달의 인보이스가 검색됩니다. YYYYMM 형식이어야 합니다. |
loiSapinInvoiceType |
사팽 법(Loi Sapin) 광고주에 대해 검색할 인보이스 유형을 선택합니다. 사팽 법(Loi Sapin) 광고주만 해당됩니다. 그렇지 않으면 무시됩니다. |
pageSize |
요청한 페이지 크기입니다. |
pageToken |
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이전 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{
"invoices": [
{
object ( |
입력란 | |
---|---|
invoices[] |
인보이스 목록입니다. 비어 있는 경우 이 목록은 표시되지 않습니다. |
nextPageToken |
결과의 다음 페이지를 검색하는 토큰입니다. 이후 반환할 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
자세한 내용은 OAuth 2.0 개요를 참고하세요.
LoiSapinInvoiceType
사팽 법(Loi Sapin) 광고주에게 제공되는 인보이스 유형입니다.
열거형 | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
값이 지정되지 않았습니다. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
미디어 비용이 포함된 인보이스입니다. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
플랫폼 수수료가 포함된 인보이스 |
인보이스
단일 인보이스
JSON 표현 |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
입력란 | |
---|---|
name |
인보이스의 리소스 이름입니다. |
invoiceId |
인보이스의 고유 ID입니다. |
displayName |
인보이스의 표시 이름입니다. |
paymentsProfileId |
인보이스가 속한 결제 프로필의 ID입니다. 인보이스 PDF에 |
paymentsAccountId |
인보이스가 속한 결제 계정의 ID입니다. 인보이스 PDF에 |
issueDate |
인보이스가 발행된 날짜입니다. |
dueDate |
인보이스의 지급 만기일입니다. |
serviceDateRange |
이 인보이스에 적용되는 서비스 시작일과 종료일입니다. |
currencyCode |
인보이스에 사용된 ISO 4217 형식의 통화입니다. |
subtotalAmountMicros |
인보이스 통화의 마이크로(micro)로 표시되는 세전 소계 금액입니다. 예를 들어 |
totalTaxAmountMicros |
인보이스에 기재된 모든 세금의 합계(단위: 인보이스 통화의 마이크로)입니다. 예를 들어 |
totalAmountMicros |
인보이스 총 금액(마이크로 단위)입니다. 예를 들어 |
purchaseOrderNumber |
인보이스와 연결된 구매주문서 번호입니다. |
budgetInvoiceGroupingId |
이 인보이스의 예산 그룹 ID입니다. 이 필드는 해당 결제 프로필의 인보이스 수준이 '예산 인보이스 그룹 ID'로 설정된 경우에만 설정됩니다. |
invoiceType |
인보이스 문서 유형입니다. |
correctedInvoiceId |
이 인보이스에서 조정되는 원래 인보이스의 ID입니다(해당하는 경우). 인보이스 PDF에
|
replacedInvoiceIds[] |
원래 발행되었으며 이 인보이스로 취소된 인보이스 ID입니다(해당하는 경우). 여러 개의 인보이스가 하나의 인보이스로 통합되면 여러 개의 인보이스가 표시될 수 있습니다. 인보이스 PDF에
|
pdfUrl |
인보이스의 PDF 사본을 다운로드할 수 있는 URL입니다. 이 URL은 사용자별로 지정되며 액세스하려면 유효한 OAuth 2.0 액세스 토큰이 필요합니다. 액세스 토큰은
URL은 이 인보이스 객체를 가져온 후 7일 동안 또는 인보이스를 다시 가져올 때까지 유효합니다. |
budgetSummaries[] |
이 인보이스와 연결된 각 예산에 대한 요약 정보 목록입니다. 이 입력란은 해당 결제 프로필의 인보이스 세부정보 수준이 '예산 수준 PO'로 설정된 경우에만 설정됩니다. |
nonBudgetMicros |
특정 예산과 무관한 비용 또는 조정의 총액을 인보이스 통화의 마이크로(micro)로 표시합니다. 예를 들어 |
InvoiceType
가능한 인보이스 유형입니다.
열거형 | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
이 버전에서 지정되지 않았거나 알 수 없습니다. |
INVOICE_TYPE_CREDIT |
인보이스에 마이너스 금액이 있습니다. |
INVOICE_TYPE_INVOICE |
인보이스 금액이 양수입니다. |
BudgetSummary
개별 캠페인 예산에 대한 요약 정보입니다.
JSON 표현 |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
입력란 | |
---|---|
externalBudgetId |
캠페인 예산의 |
prismaCpeCode |
Mediaocean Prisma 도구의 관련 고객, 제품, 견적 코드
|
preTaxAmountMicros |
세전 이 예산에 대해 발생한 청구 금액의 합계로 인보이스 통화의 마이크로로 표시됩니다. 예를 들어 |
taxAmountMicros |
이 예산 내에서 청구에 적용되는 세금으로, 인보이스 통화의 마이크로(micro)입니다. 예를 들어 |
totalAmountMicros |
세금을 포함하여 이 예산에 따른 총 청구 비용의 합계로 인보이스 통화의 마이크로로 표시됩니다. 예를 들어 |