বেশিরভাগ সংস্থান একটি Mutate পদ্ধতি ব্যবহার করে পরিবর্তিত (তৈরি করা, আপডেট করা বা সরানো হয়েছে)। Mutate পদ্ধতিটি একটি রিসোর্স-নির্দিষ্ট URL-এ একটি HTTP POST হিসাবে আহ্বান করা হয় যা রিসোর্স-নাম প্যাটার্নের সাথে মেলে, ট্রেলিং রিসোর্স আইডি ছাড়াই। মিউটেট করা সম্পদের আইডি পরিবর্তে JSON অনুরোধের বডিতে পাঠানো হয়। এটি আপনাকে একটি একক API কল পাঠাতে দেয় যা বিভিন্ন সংস্থানে একাধিক ক্রিয়াকলাপ ধারণ করে।
উদাহরণস্বরূপ, একটি প্রচারাভিযানের সম্পদের নাম নিম্নলিখিত বিন্যাস ব্যবহার করে:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
মিউটেটিং প্রচারাভিযানের জন্য ব্যবহৃত URLটি বের করতে, ট্রেলিং রিসোর্স আইডি বাদ দিন এবং যুক্ত করুন :mutate :
https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/campaigns:mutate
একটি Mutate বার্তায় একটি operations অ্যারে সহ একটি শীর্ষ-স্তরের JSON অবজেক্ট রয়েছে যাতে অনেকগুলি operation অবজেক্ট থাকতে পারে। প্রতিটি অপারেশন, ঘুরে, একটি হতে পারে: create , update বা remove । এগুলিই একমাত্র সম্ভাব্য মিউটেট অপারেশন।
POST /v16/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 /v16/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 /v16/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 /v16/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"
}
]
}