म्यूट करें

ज़्यादातर संसाधन Mutate का इस्तेमाल करके बनाए जाते हैं, बनाए जाते हैं, अपडेट किए जाते हैं या हटाए जाते हैं तरीका. किसी खास रिसॉर्स के लिए, Mutate तरीके को एचटीटीपी POST के तौर पर शुरू किया गया है ऐसा यूआरएल जो संसाधन के नाम के पैटर्न से मेल खाता है. इसके लिए, रिसॉर्स आईडी के बाद का यूआरएल इस्तेमाल नहीं किया जाता. म्यूट किए जाने वाले रिसॉर्स के आईडी, JSON अनुरोध में भेजे जाते हैं शरीर. इससे आपको एक ऐसा एपीआई कॉल भेजने की सुविधा मिलती है जिसमें कई ऑपरेशन शामिल होते हैं को ट्रैक करने की ज़रूरत नहीं है.

उदाहरण के लिए, किसी कैंपेन के संसाधन का नाम इस फ़ॉर्मैट का इस्तेमाल करता है:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

कैंपेन में बदलाव करने के लिए इस्तेमाल होने वाला यूआरएल पाने के लिए, बाद में आने वाले रिसॉर्स आईडी को छोड़ दें और :mutate जोड़ें:

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

Mutate मैसेज में, operations कलेक्शन वाला टॉप लेवल JSON ऑब्जेक्ट मौजूद है जिसमें कई operation ऑब्जेक्ट हो सकते हैं. इसके बाद, हर कार्रवाई एक हो सकती है इनमें से: create, update या remove. सिर्फ़ ये बदलाव किए जा सकते हैं कार्रवाइयां.

POST /v17/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": [
    ...
  ]
}

ज़्यादातर सेवाएं एक ही एपीआई कॉल में हज़ारों कार्रवाइयां करने की सुविधा देती हैं. सिस्टम सीमाओं से जुड़ी जानकारी देने वाले दस्तावेज़ों अनुरोध की संख्या की सीमाएं तय करें.

किसी एक एपीआई अनुरोध में की जाने वाली कार्रवाइयां, इन कार्रवाइयों के एक सेट के तौर पर पूरी की जाती हैं डिफ़ॉल्ट का मतलब है कि वे सभी एक साथ या पूरा बैच काम नहीं करता है, कोई भी एक ऑपरेशन असफल होता है. कुछ सेवाएं partialFailure एट्रिब्यूट इस व्यवहार को बदलने के लिए. संसाधन म्यूट करना देखें का इस्तेमाल करें.

बनाएं

नई इकाइयां बनाने पर, नई इकाइयां बनाई जाती हैं और उसमें पूरा JSON शामिल होना चाहिए संसाधन का प्रतिनिधित्व करें, जिसे आप बनाना चाहते हैं.

POST /v17/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 प्रज़ेंटेशन मौजूद हो (उदाहरण के लिए, पिछले एपीआई कॉल से लौटाया गया है), लेकिन सिर्फ़ कुछ फ़ील्ड में बदलाव करना चाहते हैं. JSON ऑब्जेक्ट में काट-छांट करने के बजाय, आप सिर्फ़ फ़ील्ड नामों को updateMask में बदलाव किया गया और पूरा JSON ऑब्जेक्ट भेजें.

नीचे दिए गए उदाहरण में एक ऐसे मौजूदा कैंपेन के name और status को बदला गया है जिसमें resourceName दिया गया है.

POST /v17/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 Ads स्थिति को इस पर सेट करें REMOVED. सिर्फ़ हटाए जाने वाले resourceName की ज़रूरत है.

POST /v17/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"
    }
  ]
}