মিউটেট

বেশিরভাগ রিসোর্স Mutate পদ্ধতি ব্যবহার করে পরিবর্তিত (তৈরি, আপডেট, অথবা অপসারণ) করা হয়। Mutate পদ্ধতিটি HTTP POST হিসেবে একটি রিসোর্স-নির্দিষ্ট URL-এ প্রেরণ করা হয় যা রিসোর্স-নাম প্যাটার্নের সাথে মেলে, ট্রেলিং রিসোর্স আইডি ছাড়াই। মিউটেট করা রিসোর্সগুলির আইডিগুলি JSON অনুরোধ বডিতে পাঠানো হয়। এটি আপনাকে একটি একক API কল পাঠাতে দেয় যাতে বিভিন্ন রিসোর্সে একাধিক অপারেশন থাকে।

উদাহরণস্বরূপ, একটি প্রচারণার রিসোর্সের নাম নিম্নলিখিত ফর্ম্যাট ব্যবহার করে:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

প্রচারণা পরিবর্তনের জন্য ব্যবহৃত URL টি বের করতে, ট্রেলিং রিসোর্স আইডি বাদ দিন এবং :mutate : যোগ করুন।

https://googleads.googleapis.com/v22/customers/CUSTOMER_ID/campaigns:mutate

একটি Mutate বার্তায় একটি শীর্ষ-স্তরের JSON অবজেক্ট থাকে যার একটি operations অ্যারে থাকে যাতে অনেকগুলি operation অবজেক্ট থাকতে পারে। প্রতিটি অপারেশন, পরিবর্তে, এর মধ্যে একটি হতে পারে: create , update , অথবা remove . এগুলিই একমাত্র সম্ভাব্য mutate অপারেশন।

POST /v22/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
  "operations": [
    ...
  ]
}

বেশিরভাগ পরিষেবা একক API কলে হাজার হাজার ক্রিয়াকলাপ সমর্থন করে। সিস্টেম লিমিটস গাইড অনুরোধের আকারের সীমাবদ্ধতাগুলি নথিভুক্ত করে।

একটি একক API অনুরোধের মধ্যে ক্রিয়াকলাপগুলি ডিফল্টরূপে একটি ক্রিয়াকলাপের সেট হিসাবে সম্পাদিত হয়, যার অর্থ হয় সমস্ত একসাথে সফল হয় অথবা যদি কোনও একক অপারেশন ব্যর্থ হয় তবে পুরো ব্যাচ ব্যর্থ হয়। কিছু পরিষেবা এই আচরণ পরিবর্তন করার জন্য একটি partialFailure বৈশিষ্ট্য সমর্থন করে। মিউটেট অপারেশন সেমেন্টিক্স সম্পর্কে আরও বিস্তারিত তথ্যের জন্য মিউটেটিং রিসোর্স দেখুন।

তৈরি করুন

ক্রিয়েট অপারেশন নতুন সত্তা তৈরি করে এবং আপনার তৈরি করতে ইচ্ছুক রিসোর্সের একটি সম্পূর্ণ JSON উপস্থাপনা অন্তর্ভুক্ত করতে হবে।

POST /v22/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
  "operations": [
    {
    "create": {
        "name": "An example campaign",
        "status": "PAUSED",
        "campaignBudget": "customers/CUSTOMER_ID/campaignBudgets/CAMPAIGN_BUDGET_ID",
        "advertisingChannelType": "SEARCH",
        "networkSettings": {
          "targetGoogleSearch": true,
          "targetSearchNetwork": true,
          "targetContentNetwork": true,
          "targetPartnerSearchNetwork": false
        },
        "target_spend": {}
      }
    }
  ]
}

আপডেট

আপডেট অপারেশনগুলি একটি বিদ্যমান রিসোর্সে স্পার্স আপডেট সম্পাদন করে। আপনাকে কেবল সেই ক্ষেত্রগুলি নির্দিষ্ট করতে হবে যা আপনি পরিবর্তন করতে চান।

আপনি যে ক্ষেত্রগুলি আপডেট করতে চান তা নির্দিষ্ট করতে, updateMask অ্যাট্রিবিউটটিকে কমা দ্বারা পৃথক করা ক্ষেত্রের নামের তালিকায় সেট করুন। এটি বিশেষভাবে কার্যকর যদি আপনার ইতিমধ্যেই কোনও বস্তুর সম্পূর্ণরূপে গঠিত JSON উপস্থাপনা থাকে (উদাহরণস্বরূপ, পূর্ববর্তী API কল দ্বারা ফেরত পাঠানো হয়েছে), কিন্তু শুধুমাত্র নির্দিষ্ট ক্ষেত্রগুলি পরিবর্তন করতে চান। JSON অবজেক্টটি ছাঁটাই করার পরিবর্তে, আপনি কেবল updateMask এ পরিবর্তন করার জন্য ক্ষেত্রের নামগুলি তালিকাভুক্ত করতে পারেন এবং সম্পূর্ণ JSON অবজেক্টটি পাঠাতে পারেন।

নিম্নলিখিত উদাহরণটি প্রদত্ত resourceName সহ একটি বিদ্যমান প্রচারণার name এবং status পরিবর্তন করে।

POST /v22/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
  "operations": [
    {
      "updateMask": "name,status",
      "update": {
        "resourceName": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID",
        "name": "My renamed campaign",
        "status": "PAUSED",
      }
    }
  ]
}

অপসারণ

অপসারণের ক্রিয়াকলাপগুলি কার্যকরভাবে একটি বস্তু মুছে ফেলে, এর Google বিজ্ঞাপনের স্থিতি REMOVED এ সেট করে। শুধুমাত্র অপসারণের জন্য resourceName প্রয়োজন।

POST /v22/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
  "operations": [
    {
      "remove": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID"
    }
  ]
}