Marketplace API로 이전

API 사용 설정

다른 Authorized Buyers와 유사 API를 사용하려면 Marketplace API 사용할 수 있습니다. 다음 단계에 따라 Marketplace API를 사용 설정할 수 있습니다.

  1. Google API 콘솔 지원 API로 이동 페이지를 참조하세요. 그런 다음 다른 Authorized Buyers API(예: Ad Exchange 구매자 II 또는 실시간 입찰 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 구매자 II API 범위를 사용한 기존 OAuth 2.0 워크플로는 다음과 같아야 합니다. Marketplace API 범위를 사용하도록 변경되었습니다.

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

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

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

클라이언트

Ad Exchange 구매자 II API의 accounts.clients 드림 Marketplace API의 리소스 또는 buyers.clients 리소스도 제공합니다

리소스 메서드

Ad Exchange 구매자 II API 마켓플레이스 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

초대 및 사용자 수

마켓플레이스 API는 Ad Exchange 구매자 II API의 accounts.clients.invitations 드림 및 accounts.clients.users 모든 리소스를 하나의 buyers.clients.users 리소스도 제공합니다

리소스 메서드

Ad Exchange 구매자 II API 마켓플레이스 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 마켓플레이스 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 구매자 II API의 accounts.publisherProfiles 드림 Marketplace API의 리소스 또는 buyers.publisherProfiles 리소스도 제공합니다

리소스 메서드

Ad Exchange 구매자 II API 마켓플레이스 API
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

이 메서드는 이제 목록 필터

리소스 필드

Ad Exchange 구매자 II API 마켓플레이스 API
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId는 게시자 프로필 리소스입니다. 있습니다.
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

제안서 및 FinalizedProposals

Ad Exchange 구매자 II API의 accounts.proposals 드림 Marketplace API의 리소스 또는 buyers.proposals 리소스도 제공합니다 거래는 제안서에서 buyers.proposals.deals 드림 하위 리소스로 구성됩니다. 확정된 제안서는 더 이상 API에 표시되지 않으므로 Ad Exchange를 통해 확정된 거래를 보다 세밀하게 buyers.finalizedDeals 드림 리소스도 제공합니다

리소스 메서드

Ad Exchange 구매자 II API 마켓플레이스 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는 단일 항목으로 채워지지 않았습니다. 따라서 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에서 확인할 수 있습니다. 예를 들어 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