Marketplace API로 이전

API 사용 설정

다른 Authorized Buyers API와 마찬가지로 Marketplace API를 사용하려면 먼저 사용 설정해야 합니다. 다음 단계에 따라 Marketplace API를 사용 설정할 수 있습니다.

  1. Google API 콘솔 사용 설정된 API 페이지로 이동합니다. Ad Exchange Buyer II 또는 Real-time Bidding API와 같은 다른 Authorized Buyers API에 액세스하는 데 사용하는 프로젝트를 선택합니다.
  2. + API 및 서비스 사용 설정 링크를 클릭합니다.
  3. 검색창에 'Authorized Buyers Marketplace API'를 입력하고 Enter 키를 누릅니다.
  4. 검색 결과에서 Authorized Buyers Marketplace API를 선택합니다.
  5. 사용 설정 버튼을 클릭하여 Marketplace API를 사용 설정합니다.
  6. 이제 이 프로젝트에서 만든 사용자 인증 정보로 Marketplace API에 액세스할 수 있습니다.

OAuth 2.0 사용자 인증 정보 업데이트

Ad Exchange Buyer II API 범위가 있는 기존 OAuth 2.0 워크플로는 Marketplace API 범위를 사용하도록 변경해야 합니다.

https://www.googleapis.com/auth/authorized-buyers-marketplace

서비스 계정 OAuth 2.0 흐름을 사용하여 API에 액세스하는 것이 좋습니다. 지원되는 모든 OAuth 2.0 흐름에서 Marketplace API에 액세스할 수 있는 Google의 토큰을 요청하려면 새 API 범위를 지정해야 합니다.

Ad Exchange 구매자 II API 리소스를 마켓플레이스 API에 매핑하기

클라이언트

Ad Exchange Buyer II API의 accounts.clients 리소스를 사용하는 경우 Marketplace API의 buyers.clients 리소스로 이전할 수 있습니다.

리소스 메서드

Ad Exchange 구매자 II API Marketplace API
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

이제 이 메서드가 목록 필터를 지원합니다.

accounts.clients.update buyers.clients.patch

이제 이 메서드는 updateMask 매개변수를 사용하여 부분 업데이트를 지원합니다.

리소스 필드

Ad Exchange 구매자 II API 마켓플레이스 API
Client.clientAccountId Client.name

clientAccountId는 클라이언트 리소스 ID입니다.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

이 필드는 지원 중단되었습니다.
Client.entityId

이 필드는 지원 중단되었습니다.
Client.entityName

이 필드는 지원 중단되었습니다.
Client.partnerClientId Client.partnerClientId

초대 및 사용자

Marketplace API는 Ad Exchange Buyer II API의 accounts.clients.invitations 및 accounts.clients.users 리소스의 기능을 단일 buyers.clients.users 리소스로 결합합니다.

리소스 메서드

Ad Exchange 구매자 II API Marketplace API
accounts.clients.invitations.create buyers.clients.users.create
accounts.clients.invitations.get buyers.clients.users.get
accounts.clients.invitations.list buyers.clients.users.list

state가 INVITED로 설정된 사용자만 accounts.clients.invitations.list에서 반환된 사용자와 동일합니다.

accounts.clients.users.get buyers.clients.users.get
accounts.clients.users.list buyers.clients.users.list
accounts.clients.users.update

더 이상 API로 클라이언트 사용자를 패치할 수 없습니다. buyers.clients.users.delete를 사용하여 클라이언트 사용자를 삭제하고 원하는 변경사항으로 다시 만드는 것이 좋습니다.

리소스 필드

Ad Exchange 구매자 II API Marketplace API
ClientUserInvitation.invitationId

이 필드는 지원 중단되었습니다.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

고객 사용자에게는 이 입력란이 더 이상 존재하지 않습니다. 대신 상위 클라이언트 이름에서 clientAccountId를 확인합니다.
ClientUser.userId ClientUser.name

userId는 사용자 리소스 ID입니다.
ClientUser.clientAccountId

고객 사용자에게는 이 입력란이 더 이상 존재하지 않습니다. 대신 상위 클라이언트의 이름에서 clientAccountId를 확인합니다.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

제품

이 리소스와 기능은 Marketplace API에서 사용할 수 없습니다.

PublisherProfiles

Ad Exchange Buyer II API의 accounts.publisherProfiles 리소스를 사용하는 경우 Marketplace API의 buyers.publisherProfiles 리소스로 이전할 수 있습니다.

리소스 메서드

Ad Exchange 구매자 II API Marketplace API
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

이제 이 메서드는 목록 필터를 지원합니다.

리소스 필드

Ad Exchange 구매자 II API Marketplace API
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId는 게시자 프로필 리소스 ID입니다.
PublisherProfile.seller.accountId PublisherProfile.seller.accountId
PublisherProfile.seller.subAccountId PublisherProfile.seller.subAccountId
PublisherProfile.displayName PublisherProfile.displayName
PublisherProfile.domains PublisherProfile.domains
PublisherProfile.mobileApps PublisherProfile.mobileApps
PublisherProfile.logoUrl PublisherProfile.logoUrl
PublisherProfile.directDealsContact PublisherProfile.directDealsContact
PublisherProfile.programmaticDealsContact PublisherProfile.programmaticDealsContact
PublisherProfile.mediaKitUrl PublisherProfile.mediaKitUrl
PublisherProfile.samplePageUrl PublisherProfile.samplePageUrl
PublisherProfile.rateCardUrl

이 필드는 지원 중단되었습니다.
PublisherProfile.googlePlusUrl

이 필드는 지원 중단되었습니다.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Proposals 및 FinalizedProposals

Ad Exchange Buyer II API의 accounts.proposals 리소스를 사용하는 경우 Marketplace API의 buyers.proposals 리소스로 이전할 수 있습니다. 특가가 제안서에서 buyers.proposals.deals 하위 리소스로 분리되었습니다. 최종 제안서는 더 이상 API에 표시되지 않으므로 buyers.finalizedDeals 리소스를 사용하여 최종 거래를 더 세부적으로 제어할 수 있습니다.

리소스 메서드

Ad Exchange 구매자 II API Marketplace API
accounts.proposals.accept buyers.proposals.accept

제안서의 상태가 BUYER_ACCEPTANCE_REQUESTED인 경우에만 buyers.proposals.accept를 호출합니다.
accounts.proposals.addNote buyers.proposals.addNote
accounts.proposals.cancelNegotiation buyers.proposals.cancelNegotiation
accounts.proposals.completeSetup buyers.finalizedDeals.setReadyToServe
accounts.proposals.create buyers.proposals.sendRfp
accounts.proposals.get buyers.proposals.get

제안서에는 더 이상 특가 정보가 포함되지 않습니다.

accounts.proposals.list buyers.proposals.list

반환된 제안서에는 더 이상 특가에 관한 정보가 포함되지 않습니다. 목록 필터링을 사용하는 경우 Marketplace API는 목록 필터 구문만 지원합니다.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

이제 이 메서드는 updateMask 매개변수를 사용하여 부분 업데이트를 지원합니다.
accounts.finalizedProposals.list

buyers.finalizedDeals.list를 사용하여 특정 구매자 계정의 완료된 거래를 확인합니다. 이제 bidders.finalizedDeals.list를 사용하여 입찰자 수준에서 확정된 거래를 가져올 수 있습니다.
accounts.finalizedProposals.pause

buyers.finalizedDeals.pause를 사용하여 특정 구매자 계정의 완료된 개별 거래를 일시중지합니다.
accounts.finalizedProposals.resume

buyers.finalizedDeals.resume를 사용하여 특정 구매자 계정의 완료된 개별 거래를 재개합니다.

리소스 필드

proposals 및 finalizedProposals 리소스는 동일한 Proposal 표현을 공유하며 유사한 이전 단계를 따릅니다.

Ad Exchange 구매자 II API 마켓플레이스 API
Proposal.proposalId Proposal.name

proposalId는 제안서 리소스 ID입니다.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision 및 Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId는 거래 리소스 ID입니다.
Proposal.deals.proposalId Deal.name

proposalId는 상위 제안서 리소스 ID입니다.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

이 필드는 지원 중단되었습니다.
Proposal.deals.createProductRevision

이 필드는 지원 중단되었습니다.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

이 필드는 지원 중단되었습니다. 이제 제안서 수준에서만 노출됩니다.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

이 필드는 지원 중단되었습니다.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

이 필드는 지원 중단되었습니다.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

guaranteedFixedPriceTerms.fixedPrices는 반복 필드이지만 항목이 2개 이상으로 채워진 적은 없습니다. 따라서 Marketplace API의 programmaticGuaranteedTerms.fixedPrice은 동일합니다.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

nonGuaranteedFixedPriceTerms.fixedPrices는 반복되는 필드이지만 하나 이상의 항목으로 채워지지 않았습니다. 따라서 Marketplace API의 preferredDealTerms.fixedPrice는 동일합니다.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

nonGuaranteedAuctionTerms.reservePricesPerBuyer는 반복 필드이지만 항목이 두 개 이상 채워진 적은 없습니다. 따라서 Marketplace API의 privateAuctionTerms.floorPrice는 동일합니다.
Proposal.deals.webPropertyCode

이 필드는 지원 중단되었습니다.
Proposal.deals.sellerContacts Proposal.sellerContacts
Proposal.deals.availableStartTime Proposal.flightStartTime
Proposal.deals.availableEndTime Proposal.flightEndTime
Proposal.deals.description Proposal.description
Proposal.deals.targetingCriterion Deal.targeting

키를 사용하여 타겟팅 카테고리를 결정하는 타겟팅을 더 이상 구성할 수 없습니다. 하지만 타겟팅할 수 있는 카테고리는 Deal.targeting에서 확인할 수 있습니다. 예를 들어 Ad Exchange Buyer II의 GOOG_CREATIVE_SIZE 키는 Marketplace API의 Deal.targeting.inventorySizeTargeting를 참조합니다.
Proposal.deals.targeting Deal.targeting

타겟팅 기준 카테고리가 추가되었습니다.
Proposal.deals.creativeRestrictions.creativeFormat Deal.creativeRequirements.creativeFormat
Proposal.deals.creativeRestrictions.skippableAdType Deal.creativeRequirements.skippableAdType
Proposal.deals.creativeRestrictions.creativeSpecifications.creativeSize Deal.targeting.inventorySizeTargeting
Proposal.deals.externalDealId

이 필드는 지원 중단되었습니다.
Proposal.deals.syndicationProduct

이 필드는 지원 중단되었습니다.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

FinalizedDeal.dealPausingInfo 필드에서 비슷한 정보를 찾을 수 있습니다.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

특가가 표시되는 방식에 관한 추가 세부정보가 추가되었습니다.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

이제 거래가 확정된 경우에만 게재할 준비가 되었음을 알릴 수 있습니다. buyers.finalizedDeals.setReadyToServe 메서드를 사용하여 최종화된 보장 프로그래매틱 거래를 게재할 준비가 되었음을 나타냅니다.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

게시자 프로필 이름을 사용하여 판매자를 식별합니다. buyers.publisherProfiles 리소스로 게시자 프로필을 볼 수 있습니다.
Proposal.seller.subAccountId Proposal.publisherProfile

게시자 프로필 이름을 사용하여 판매자를 식별합니다. buyers.publisherProfiles 리소스로 게시자 프로필을 볼 수 있습니다.
Proposal.buyer.accountId

Proposal.buyer 또는 Proposal.client.

사용되는 필드는 협상하는 구매자의 계정 유형에 따라 다릅니다. 각각 Real-time Bidding API buyers 리소스 또는 Marketplace API buyers.clients 리소스의 리소스 이름입니다.
Proposal.billedBuyer.accountId Proposal.billedBuyer

이제 이는 실시간 입찰 API의 buyers 리소스에 표시된 대로 구매자 계정을 나타내는 리소스 이름입니다.
Proposal.displayName Proposal.displayName
Proposal.proposalState Proposal.state
Proposal.isRenegotiating Proposal.isRenegotiating
Proposal.buyerPrivateData Proposal.buyerPrivateData
Proposal.sellerContacts Proposal.sellerContacts
Proposal.buyerContacts Proposal.buyerContacts
Proposal.privateAuctionId

이 필드는 지원 중단되었습니다.
Proposal.isSetupComplete FinalizedDeal.readyToServe

이제 buyers.finalizedDeals를 사용하여 더 세부적으로 액세스할 수 있습니다.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

이 필드는 지원 중단되었습니다.
Proposal.notes.noteId

이 필드는 지원 중단되었습니다.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions