Method: exchanges.auctionPackages.patch

একটি নিলাম প্যাকেজ আপডেট করে।

HTTP অনুরোধ

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
auctionPackage.name

string

শনাক্তকারী। এই নিলাম প্যাকেজের জন্য আপেক্ষিক রিসোর্স নাম। exchanges/{seller_id}/auctionpackages/{auction_package_id} এই ফর্ম্যাটের হওয়া উচিত। উদাহরণ: exchanges/1234/auctionPackage/5678 ।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
ক্ষেত্র
auctionPackage.displayName

string

আবশ্যক। এই নিলাম প্যাকেজের প্রদর্শিত নাম। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২৪০ অক্ষরের মধ্যে সীমাবদ্ধ থাকবে।

auctionPackage.status

enum ( DiscoveryObjectStatus )

প্রয়োজনীয়। এই নিলাম প্যাকেজের অবস্থা। PAUSED বা REMOVED স্ট্যাটাসযুক্ত প্যাকেজগুলি DV3 বিজ্ঞাপনদাতাদের দেখানো হয় না।

auctionPackage.description

string

আবশ্যক। এই প্যাকেজের জন্য বিবরণী টেক্সট। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২০০০ অক্ষর।

auctionPackage.format

enum ( Format )

আবশ্যক। অপরিবর্তনীয়। অন্তর্নিহিত বিজ্ঞাপন ফরম্যাটের ধরণ। তৈরির পর আপডেট করার অনুমতি নেই।

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

ঐচ্ছিক। এই নিলাম প্যাকেজের ইনভেন্টরির পূর্বাভাসের বিস্তারিত বিবরণ। DV3 বিজ্ঞাপনদাতারা এই বিবরণগুলো দেখতে এবং ফিল্টার করতে পারেন।

auctionPackage.externalDealId

string

আবশ্যক। অপরিবর্তনীয়। বিড অনুরোধে ব্যবহৃত এক্সচেঞ্জ ডিল আইডি। সর্বোচ্চ ১০০ অক্ষর। অনুমোদিত অক্ষরগুলো হলো অ্যালফানিউমেরিক, আন্ডারস্কোর, ড্যাশ এবং ডট। তৈরির পর কোনো আপডেট করা যাবে না।

auctionPackage.logoUrl

string

শুধুমাত্র আউটপুট। এই নিলাম প্যাকেজের লোগোর ইউআরএল।

auctionPackage.floorPrice

object ( Money )

প্রয়োজনীয়। এই নিলাম প্যাকেজের সর্বনিম্ন মূল্য।

auctionPackage.startTime

string ( Timestamp format)

আবশ্যক। যে সময়ে এই নিলাম প্যাকেজটি সক্রিয় হবে। তা অবশ্যই শেষ সময়ের (endTime) আগে হতে হবে। শুরুর সময় ভবিষ্যতের ১ বছরের বেশি হতে পারবে না।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.endTime

string ( Timestamp format)

প্রয়োজনীয়। যে সময়ে এই নিলাম প্যাকেজটি নিষ্ক্রিয় হয়ে যাবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.mediumType

enum ( MediumType )

প্রয়োজনীয়। নিলাম প্যাকেজের মাঝারি ধরন।

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

ঐচ্ছিক। মালিক যদি কোনো স্বল্প প্রতিনিধিত্বকারী গোষ্ঠীর সদস্য হন, তবে তা উল্লেখ করতে হবে।

updateMask

string ( FieldMask format)

ঐচ্ছিক। কোন কোন ফিল্ড আপডেট করা হবে তা নিয়ন্ত্রণ করার মাস্ক।

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

auctionPackage.dv3MarketplaceUri

string

শুধুমাত্র আউটপুট। মার্কেটপ্লেসে নিলাম প্যাকেজের জন্য DV360 লিঙ্ক।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে AuctionPackage এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/doubleclickbidmanager

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

,

একটি নিলাম প্যাকেজ আপডেট করে।

HTTP অনুরোধ

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
auctionPackage.name

string

শনাক্তকারী। এই নিলাম প্যাকেজের জন্য আপেক্ষিক রিসোর্স নাম। exchanges/{seller_id}/auctionpackages/{auction_package_id} এই ফর্ম্যাটের হওয়া উচিত। উদাহরণ: exchanges/1234/auctionPackage/5678 ।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
ক্ষেত্র
auctionPackage.displayName

string

আবশ্যক। এই নিলাম প্যাকেজের প্রদর্শিত নাম। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২৪০ অক্ষরের মধ্যে সীমাবদ্ধ থাকবে।

auctionPackage.status

enum ( DiscoveryObjectStatus )

প্রয়োজনীয়। এই নিলাম প্যাকেজের অবস্থা। PAUSED বা REMOVED স্ট্যাটাসযুক্ত প্যাকেজগুলি DV3 বিজ্ঞাপনদাতাদের দেখানো হয় না।

auctionPackage.description

string

আবশ্যক। এই প্যাকেজের জন্য বিবরণী টেক্সট। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২০০০ অক্ষর।

auctionPackage.format

enum ( Format )

আবশ্যক। অপরিবর্তনীয়। অন্তর্নিহিত বিজ্ঞাপন ফরম্যাটের ধরণ। তৈরির পর আপডেট করার অনুমতি নেই।

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

ঐচ্ছিক। এই নিলাম প্যাকেজের ইনভেন্টরির পূর্বাভাসের বিস্তারিত বিবরণ। DV3 বিজ্ঞাপনদাতারা এই বিবরণগুলো দেখতে এবং ফিল্টার করতে পারেন।

auctionPackage.externalDealId

string

আবশ্যক। অপরিবর্তনীয়। বিড অনুরোধে ব্যবহৃত এক্সচেঞ্জ ডিল আইডি। সর্বোচ্চ ১০০ অক্ষর। অনুমোদিত অক্ষরগুলো হলো অ্যালফানিউমেরিক, আন্ডারস্কোর, ড্যাশ এবং ডট। তৈরির পর কোনো আপডেট করা যাবে না।

auctionPackage.logoUrl

string

শুধুমাত্র আউটপুট। এই নিলাম প্যাকেজের লোগোর ইউআরএল।

auctionPackage.floorPrice

object ( Money )

প্রয়োজনীয়। এই নিলাম প্যাকেজের সর্বনিম্ন মূল্য।

auctionPackage.startTime

string ( Timestamp format)

আবশ্যক। যে সময়ে এই নিলাম প্যাকেজটি সক্রিয় হবে। তা অবশ্যই শেষ সময়ের (endTime) আগে হতে হবে। শুরুর সময় ভবিষ্যতের ১ বছরের বেশি হতে পারবে না।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.endTime

string ( Timestamp format)

প্রয়োজনীয়। যে সময়ে এই নিলাম প্যাকেজটি নিষ্ক্রিয় হয়ে যাবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.mediumType

enum ( MediumType )

প্রয়োজনীয়। নিলাম প্যাকেজের মাঝারি ধরন।

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

ঐচ্ছিক। মালিক যদি কোনো স্বল্প প্রতিনিধিত্বকারী গোষ্ঠীর সদস্য হন, তবে তা উল্লেখ করতে হবে।

updateMask

string ( FieldMask format)

ঐচ্ছিক। কোন কোন ফিল্ড আপডেট করা হবে তা নিয়ন্ত্রণ করার মাস্ক।

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

auctionPackage.dv3MarketplaceUri

string

শুধুমাত্র আউটপুট। মার্কেটপ্লেসে নিলাম প্যাকেজের জন্য DV360 লিঙ্ক।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে AuctionPackage এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/doubleclickbidmanager

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

,

একটি নিলাম প্যাকেজ আপডেট করে।

HTTP অনুরোধ

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
auctionPackage.name

string

শনাক্তকারী। এই নিলাম প্যাকেজের জন্য আপেক্ষিক রিসোর্স নাম। exchanges/{seller_id}/auctionpackages/{auction_package_id} এই ফর্ম্যাটের হওয়া উচিত। উদাহরণ: exchanges/1234/auctionPackage/5678 ।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
ক্ষেত্র
auctionPackage.displayName

string

আবশ্যক। এই নিলাম প্যাকেজের প্রদর্শিত নাম। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২৪০ অক্ষরের মধ্যে সীমাবদ্ধ থাকবে।

auctionPackage.status

enum ( DiscoveryObjectStatus )

প্রয়োজনীয়। এই নিলাম প্যাকেজের অবস্থা। PAUSED বা REMOVED স্ট্যাটাসযুক্ত প্যাকেজগুলি DV3 বিজ্ঞাপনদাতাদের দেখানো হয় না।

auctionPackage.description

string

আবশ্যক। এই প্যাকেজের জন্য বিবরণী টেক্সট। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২০০০ অক্ষর।

auctionPackage.format

enum ( Format )

আবশ্যক। অপরিবর্তনীয়। অন্তর্নিহিত বিজ্ঞাপন ফরম্যাটের ধরণ। তৈরির পর আপডেট করার অনুমতি নেই।

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

ঐচ্ছিক। এই নিলাম প্যাকেজের ইনভেন্টরির পূর্বাভাসের বিস্তারিত বিবরণ। DV3 বিজ্ঞাপনদাতারা এই বিবরণগুলো দেখতে এবং ফিল্টার করতে পারেন।

auctionPackage.externalDealId

string

আবশ্যক। অপরিবর্তনীয়। বিড অনুরোধে ব্যবহৃত এক্সচেঞ্জ ডিল আইডি। সর্বোচ্চ ১০০ অক্ষর। অনুমোদিত অক্ষরগুলো হলো অ্যালফানিউমেরিক, আন্ডারস্কোর, ড্যাশ এবং ডট। তৈরির পর কোনো আপডেট করা যাবে না।

auctionPackage.logoUrl

string

শুধুমাত্র আউটপুট। এই নিলাম প্যাকেজের লোগোর ইউআরএল।

auctionPackage.floorPrice

object ( Money )

প্রয়োজনীয়। এই নিলাম প্যাকেজের সর্বনিম্ন মূল্য।

auctionPackage.startTime

string ( Timestamp format)

আবশ্যক। যে সময়ে এই নিলাম প্যাকেজটি সক্রিয় হবে। তা অবশ্যই শেষ সময়ের (endTime) আগে হতে হবে। শুরুর সময় ভবিষ্যতের ১ বছরের বেশি হতে পারবে না।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.endTime

string ( Timestamp format)

প্রয়োজনীয়। যে সময়ে এই নিলাম প্যাকেজটি নিষ্ক্রিয় হয়ে যাবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

auctionPackage.mediumType

enum ( MediumType )

প্রয়োজনীয়। নিলাম প্যাকেজের মাঝারি ধরন।

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

ঐচ্ছিক। মালিক যদি কোনো স্বল্প প্রতিনিধিত্বকারী গোষ্ঠীর সদস্য হন, তবে তা উল্লেখ করতে হবে।

updateMask

string ( FieldMask format)

ঐচ্ছিক। কোন কোন ফিল্ড আপডেট করা হবে তা নিয়ন্ত্রণ করার মাস্ক।

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

auctionPackage.dv3MarketplaceUri

string

শুধুমাত্র আউটপুট। মার্কেটপ্লেসে নিলাম প্যাকেজের জন্য DV360 লিঙ্ক।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে AuctionPackage এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/doubleclickbidmanager

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .