دارایی‌ها

قبل‌از ایجاد پویش «عملکرد بیشینه»، مهم است که همه دارایی‌هایی را که قصد دارید در پویش استفاده کنید وارد کنید. همیشه می‌توانید برگردید و دارایی‌ها را بعداً اضافه کنید، اما برای شروع به مجموعه‌ای از دارایی‌ها نیاز دارید.

هنگام برنامه‌ریزی پویش، درباره دارایی‌ها و الزامات دارایی برای پویش‌های «عملکرد بیشینه» مطالعه کنید.

ازآنجایی‌که دارایی‌های متن و دارایی‌های تصویر انواع دارایی‌های اصلی موردنیاز هستند، این راهنما نحوه بارگذاری هریک از آن‌ها را نشان می‌دهد. این اصول را می‌توان به انواع دیگر دارایی نیز تعمیم داد. مهم نیست چه نوع دارایی‌ای می‌سازید، از AssetOperation برای ایجاد آن استفاده کنید.

دارایی‌ها را می‌توان بااستفاده از AdsApp بدون استفاده از mutate ایجاد کرد، اما برای حفظ سازگاری، این راهنما آن را به همان روشی انجام می‌دهد که بقیه عملیات‌ها انجام می‌دهند. توجه داشته باشید که اگر ازقبل دارایی‌هایی دردسترس دارید، می‌توانید و باید از آن‌ها استفاده مجدد کنید. بنابراین، اگرچه داشتن دارایی برای ایجاد پویش «عملکرد بیشینه» الزامی است، اما ممکن است ایجاد آن‌ها به‌عنوان بخشی از فرایند ایجاد پویش الزامی نباشد.

دارایی‌های نوشتاری

دارایی‌های نوشتاری درست مثل هر عملیات دیگری کار می‌کنند. اگر دارایی‌ها را به‌عنوان بخشی از فرایند ایجاد پویش بارگذاری می‌کنید، از شناسه موقت استفاده کنید. درغیراین‌صورت، نام منبع برگشتی را یادداشت کنید تا در عملیات آینده هنگام ارجاع دادن به دارایی برای افزودن آن به گروه دارایی استفاده کنید.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

دارایی‌های تصویر

دارایی‌های تصویری در قالب کدبندی‌شده با پایه ۶۴ بارگذاری می‌شوند. ازآنجایی‌که نمی‌توانید تصاویر را مستقیماً در دستورگان‌های Google Ads بارگذاری کنید، دو رویکرد مختلف برای دریافت داده‌های تصویر و کدبندی آن برای بارگذاری دارید.

برای واکشی تصویر از Google Drive، ابتدا به شناسه آن نیاز دارید که بهترین راه برای شناسایی منحصربه‌فرد تصویر است. یکی از راه‌های دریافت شناسه این است که پیوند هم‌رسانی‌شدنی را از واسط کاربر Google Drive کپی کنید و شناسه را استخراج کنید. همچنین می‌توانید مجموعه‌ای از فایل‌ها را به‌صورت برنامه‌نویسی‌شده واکشی کنید و فایل‌هایی را که می‌خواهید بارگذاری کنید انتخاب کنید. این کد نحوه بارگذاری یک تصویر با شناسه مشخص را نشان می‌دهد:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}
operations.push(imageAsset);

یا می‌توانید بااستفاده از UrlFetchApp، تصویری را که در سرور وب میزبانی می‌شود ازطریق نشانی وب آن واکشی کنید:

const file = UrlFetchApp.fetch(imageUrl);

سپس می‌توانید getBlob را در این فایل فراخوانی کنید، درست مانند کاری که با فایل Drive انجام می‌دهید، بنابراین ساختار عملیات با مراحل مربوط به فایل Google Drive یکسان است.