Marketplace API로 이전

API 사용 설정

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

  1. Google API 콘솔에서 사용 설정된 API 페이지로 이동합니다. Ad Exchange 구매자 II 또는 실시간 입찰 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 사용자 인증 정보 업데이트

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

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

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

Ad Exchange 구매자 II API 리소스를 Marketplace 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 Marketplace 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

제안 및 완성된 제안

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 Marketplace 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는 반복되는 필드이지만 두 개 이상의 항목으로 채워지지 않았습니다. 따라서 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 구매자 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-timeBidding 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