- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 인보이스
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- InvoiceType
- AccountBudgetSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- InvalidActivitySummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AccountSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
특정 월의 결제 설정과 연결된 모든 인보이스를 반환합니다.
발생한 오류 목록: AuthenticationError AuthorizationError FieldError HeaderError InternalError InvoiceError QuotaError RequestError
HTTP 요청
GET https://googleads.googleapis.com/v17/customers/{customerId}/invoices
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 인보이스를 가져올 고객의 ID입니다. |
쿼리 매개변수
매개변수 | |
---|---|
billingSetup |
필수 항목입니다. 요청된 인보이스의 결제 설정 리소스 이름입니다.
|
issueYear |
필수 항목입니다. 인보이스를 검색할 발행 연도(yyyy 형식)입니다. 2019년 이후에 발행된 인보이스만 가져올 수 있습니다. |
issueMonth |
필수 항목입니다. 인보이스를 검색할 발행 월입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
InvoiceService.ListInvoices
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"invoices": [
{
object ( |
필드 | |
---|---|
invoices[] |
결제 설정 및 기간과 일치하는 인보이스 목록입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
인보이스
인보이스입니다. 모든 인보이스 정보는 PDF 인보이스와 일치하도록 스냅샷 처리됩니다. 인보이스 서비스 출시 이전의 인보이스의 경우 스냅샷 정보가 PDF 인보이스와 일치하지 않을 수 있습니다.
JSON 표현 |
---|
{ "resourceName": string, "type": enum ( |
필드 | |
---|---|
resourceName |
출력 전용입니다. 인보이스의 리소스 이름입니다. 여러 고객이 하나의 인보이스를 공유할 수 있으므로 여러 리소스 이름이 동일한 인보이스를 가리킬 수 있습니다. 인보이스 리소스 이름의 형식은 다음과 같습니다.
|
type |
출력 전용입니다. 인보이스 유형입니다. |
serviceDateRange |
출력 전용입니다. 이 인보이스의 서비스 기간 기간입니다. 종료일에는 포함되지 않습니다. |
adjustmentsSubtotalAmountMicros |
출력 전용입니다. 인보이스 수준 조정의 세전 소계 금액(마이크로 단위)입니다. |
adjustmentsTaxAmountMicros |
출력 전용입니다. 인보이스 수준 조정에 대한 세금 합계(마이크로 단위)입니다. |
adjustmentsTotalAmountMicros |
출력 전용입니다. 인보이스 수준 조정의 총 금액(마이크로 단위)입니다. |
regulatoryCostsSubtotalAmountMicros |
출력 전용입니다. 인보이스 수준 규제 비용의 세전 소계 금액(마이크로 단위)입니다. |
regulatoryCostsTaxAmountMicros |
출력 전용입니다. 인보이스 수준 규제 비용에 대한 세금 합계(마이크로 단위)입니다. |
regulatoryCostsTotalAmountMicros |
출력 전용입니다. 인보이스 수준 규제 비용의 총 금액(마이크로 단위)입니다. |
replacedInvoices[] |
출력 전용입니다. 이 인보이스로 재청구 또는 대체되는 원본 인보이스의 리소스 이름입니다(해당하는 경우). 인보이스 통합으로 인해 교체된 인보이스가 여러 개 있을 수 있습니다. 교체된 인보이스가 동일한 결제 계정에 속해 있지 않을 수 있습니다.
|
accountBudgetSummaries[] |
출력 전용입니다. 이 인보이스와 관련된 계정 예산 요약 정보의 목록입니다. |
accountSummaries[] |
출력 전용입니다. 이 인보이스와 관련된 요약 계정 정보의 목록입니다. |
id |
출력 전용입니다. 인보이스의 ID입니다. 인보이스 PDF에 '인보이스 번호'로 표시됩니다. |
billingSetup |
출력 전용입니다. 이 인보이스 결제 설정의 리소스 이름입니다.
|
paymentsAccountId |
출력 전용입니다. 결제 설정과 연결된 결제 계정을 식별하는 데 사용되는 16자리 ID입니다(예: '1234-5678-9012-3456'). 인보이스 PDF에 '결제 계좌 번호'로 표시됩니다. |
paymentsProfileId |
출력 전용입니다. 결제 설정과 연결된 결제 프로필을 식별하는 데 사용되는 12자리 ID입니다(예: '1234-5678-9012'). 인보이스 PDF에 '결제 ID'로 표시됩니다. |
issueDate |
출력 전용입니다. 발행일(yyyy-mm-dd 형식)입니다. 인보이스 PDF에 '발행일'로 표시됩니다. 또는 '인보이스 날짜'입니다. |
dueDate |
출력 전용입니다. yyyy-mm-dd 형식의 마감일입니다. |
currencyCode |
출력 전용입니다. 통화 코드입니다. 모든 비용은 이 통화로 반환됩니다. ISO 4217 표준에서 파생된 통화 코드의 하위 집합이 지원됩니다. |
exportChargeSubtotalAmountMicros |
출력 전용입니다. 인보이스 수준 내보내기 요금의 세전 소계 금액(마이크로 단위)입니다. |
exportChargeTaxAmountMicros |
출력 전용입니다. 인보이스 수준 내보내기 요금에 대한 세금 합계(마이크로 단위)입니다. |
exportChargeTotalAmountMicros |
출력 전용입니다. 인보이스 수준 내보내기 요금의 총액(마이크로 단위)입니다. |
subtotalAmountMicros |
출력 전용입니다. 세전 소계 금액(마이크로 단위)입니다. AccountBudgetSummary 소계 금액과 인보이스.adjustments_subtotal_amount_micros의 합계와 같습니다. |
taxAmountMicros |
출력 전용입니다. 인보이스의 모든 세금 합계(마이크로 단위)입니다. 이는 AccountBudgetSummary 세액의 합계에 특정 계정 예산과 관련 없는 세금을 더한 것과 같습니다. |
totalAmountMicros |
출력 전용입니다. 총액(마이크로 단위)입니다. 인보이스.subtotal_amount_micros, 인보이스.tax_amount_micros, 인보이스.regulatory_costs_subtotal_amount_micros, 인보이스.export_charge_subtotal_amount_micros (V14.1부터 별도의 항목으로 구분됨)의 합계가 포함됩니다. |
correctedInvoice |
출력 전용입니다. 이 인보이스로 수정, 청구 또는 취소된 원래 인보이스의 리소스 이름입니다(해당하는 경우).
|
pdfUrl |
출력 전용입니다. 인보이스의 PDF 사본 URL입니다. 이 URL로 PDF를 요청하려면 사용자가 OAuth 토큰을 전달해야 합니다. |
InvoiceType
사용할 수 있는 인보이스 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
CREDIT_MEMO |
금액이 음수인 인보이스 계정에 크레딧이 지급됩니다. |
INVOICE |
금액이 양수인 인보이스 계정에 미결제 잔액이 있습니다. |
AccountBudgetSummary
요약된 계정 예산 청구 가능 비용을 나타냅니다.
JSON 표현 |
---|
{ "billableActivityDateRange": { object ( |
필드 | |
---|---|
billableActivityDateRange |
출력 전용입니다. 이 인보이스의 서비스 기간에 속하는 계정 예산의 청구 가능 활동 기간입니다. 종료일에는 포함되지 않습니다. 이 시간은 계정 예산의 시작 및 종료 시간과 다를 수 있습니다. |
invalidActivitySummaries[] |
출력 전용입니다. 원본 연결과 요약된 무효 활동 크레딧 목록입니다. |
customer |
출력 전용입니다. 이 계정 예산과 연결된 고객의 리소스 이름입니다. 여기에는 인보이스 PDF에 '계정 ID'로 표시되는 고객 ID가 포함됩니다. 고객 리소스 이름의 형식은 다음과 같습니다.
|
customerDescriptiveName |
출력 전용입니다. 계정 예산 고객을 설명하는 이름입니다. 인보이스 PDF에 '계정'으로 표시됩니다. |
accountBudget |
출력 전용입니다. 이 요약된 청구 가능 비용과 연결된 계정 예산의 리소스 이름입니다. AccountBudget 리소스 이름의 형식은 다음과 같습니다.
|
accountBudgetName |
출력 전용입니다. 계정 예산의 이름입니다. 인보이스 PDF에 '계정 예산'으로 표시됩니다. |
purchaseOrderNumber |
출력 전용입니다. 계정 예산의 구매주문서 번호입니다. 인보이스 PDF에 '구매주문서'로 표시됩니다. |
subtotalAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산으로 인해 발생한 세전 소계 금액(마이크로 단위)입니다. |
taxAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산에서 발생한 세액(마이크로 단위)입니다. |
totalAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산으로 발생한 총 금액(마이크로 단위)입니다. 이는 계정 예산 소계 금액과 계정 예산 세액의 합과 같습니다. |
servedAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산으로 인해 발생한 세전 처리 금액(마이크로 단위)입니다. 이 방법은 인보이스와 게재 데이터를 조정하는 데만 유용합니다. |
billedAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산으로 인해 발생한 세전 청구 금액(마이크로 단위)입니다. 조정은 반영되지 않습니다. |
overdeliveryAmountMicros |
출력 전용입니다. 서비스 기간 동안 이 예산으로 인해 발생한 세전 초과게재 금액(마이크로 단위)입니다(음수 값). |
invalidActivityAmountMicros |
출력 전용입니다. 이전 달의 이 예산에서 발생한 세전 무효 활동 금액이며 마이크로 (음수 값)로 표시됩니다. |
InvalidActivitySummary
수정이 이루어진 인보이스에 대한 추가 세부정보가 포함된 인보이스의 무효 활동에 대한 세부정보
JSON 표현 |
---|
{
"originalMonthOfService": enum ( |
필드 | |
---|---|
originalMonthOfService |
출력 전용입니다. 무효 활동 크레딧과 관련된 원래 서비스 기간(월)입니다. |
originalYearOfService |
출력 전용입니다. 이 무효 활동 크레딧과 관련된 원래 서비스 제공 연도입니다. |
originalInvoiceId |
출력 전용입니다. 이 무효 활동 크레딧과 관련된 원본 인보이스 번호입니다. |
originalAccountBudgetName |
출력 전용입니다. 무효 활동 크레딧과 관련된 원래 계정 예산 이름입니다. |
originalPurchaseOrderNumber |
출력 전용입니다. 무효 활동 크레딧과 관련된 원래 구매주문서 번호입니다. |
amountMicros |
출력 전용입니다. 무효 활동 금액 세부정보입니다. |
AccountSummary
계정 수준에서 요약된 보기를 나타냅니다.
JSON 표현 |
---|
{ "customer": string, "billingCorrectionSubtotalAmountMicros": string, "billingCorrectionTaxAmountMicros": string, "billingCorrectionTotalAmountMicros": string, "couponAdjustmentSubtotalAmountMicros": string, "couponAdjustmentTaxAmountMicros": string, "couponAdjustmentTotalAmountMicros": string, "excessCreditAdjustmentSubtotalAmountMicros": string, "excessCreditAdjustmentTaxAmountMicros": string, "excessCreditAdjustmentTotalAmountMicros": string, "regulatoryCostsSubtotalAmountMicros": string, "regulatoryCostsTaxAmountMicros": string, "regulatoryCostsTotalAmountMicros": string, "exportChargeSubtotalAmountMicros": string, "exportChargeTaxAmountMicros": string, "exportChargeTotalAmountMicros": string, "subtotalAmountMicros": string, "taxAmountMicros": string, "totalAmountMicros": string } |
필드 | |
---|---|
customer |
출력 전용입니다. 계정 요약과 연결된 계정입니다. |
billingCorrectionSubtotalAmountMicros |
출력 전용입니다. 세전 청구 수정 소계 금액(마이크로 단위)입니다. |
billingCorrectionTaxAmountMicros |
출력 전용입니다. 결제 수정에 대한 세금(마이크로 단위)입니다. |
billingCorrectionTotalAmountMicros |
출력 전용입니다. 총 청구 수정 금액(마이크로 단위)입니다. |
couponAdjustmentSubtotalAmountMicros |
출력 전용입니다. 세전 쿠폰 조정 소계 금액(마이크로 단위)입니다. |
couponAdjustmentTaxAmountMicros |
출력 전용입니다. 쿠폰 조정에 부과되는 세금(마이크로 단위)입니다. |
couponAdjustmentTotalAmountMicros |
출력 전용입니다. 총 쿠폰 조정 금액(마이크로 단위)입니다. |
excessCreditAdjustmentSubtotalAmountMicros |
출력 전용입니다. 초과 크레딧 조정 소계 금액(마이크로 단위)을 세전합니다. |
excessCreditAdjustmentTaxAmountMicros |
출력 전용입니다. 초과 크레딧 조정에 대한 세금(마이크로 단위)입니다. |
excessCreditAdjustmentTotalAmountMicros |
출력 전용입니다. 총 초과 크레딧 조정 금액(마이크로 단위)입니다. |
regulatoryCostsSubtotalAmountMicros |
출력 전용입니다. 세전 규제 비용 소계 금액(마이크로 단위) |
regulatoryCostsTaxAmountMicros |
출력 전용입니다. 규제 비용에 부과되는 세금(마이크로 단위)입니다. |
regulatoryCostsTotalAmountMicros |
출력 전용입니다. 총 규제 비용 금액(마이크로 단위) |
exportChargeSubtotalAmountMicros |
출력 전용입니다. 세전 수출 비용 소계 금액(마이크로 단위)입니다. |
exportChargeTaxAmountMicros |
출력 전용입니다. 수출 수수료에 부과되는 세금(마이크로 단위)입니다. |
exportChargeTotalAmountMicros |
출력 전용입니다. 총 내보내기 청구 금액(마이크로 단위)입니다. |
subtotalAmountMicros |
출력 전용입니다. 서비스 기간 동안 계정에서 발생한 총 세전 소계 금액(마이크로 단위)입니다. |
taxAmountMicros |
출력 전용입니다. 서비스 기간 동안 계정에서 발생한 총 세액(마이크로 단위)입니다. |
totalAmountMicros |
출력 전용입니다. 서비스 기간 동안 계정에서 발생한 총 금액(마이크로 단위)입니다. 이는 subtotalAmountMicros와 taxAmountMicros의 합계와 같습니다. |