Enum Class MediaUploadErrorEnum.MediaUploadError

java.lang.Object
java.lang.Enum<MediaUploadErrorEnum.MediaUploadError>
com.google.ads.googleads.v18.errors.MediaUploadErrorEnum.MediaUploadError
All Implemented Interfaces:
com.google.protobuf.Internal.EnumLite, com.google.protobuf.ProtocolMessageEnum, Serializable, Comparable<MediaUploadErrorEnum.MediaUploadError>, Constable
Enclosing class:
MediaUploadErrorEnum

public static enum MediaUploadErrorEnum.MediaUploadError extends Enum<MediaUploadErrorEnum.MediaUploadError> implements com.google.protobuf.ProtocolMessageEnum
 Enum describing possible media uploading errors.
 
Protobuf enum google.ads.googleads.v18.errors.MediaUploadErrorEnum.MediaUploadError
  • Enum Constant Details

    • UNSPECIFIED

      public static final MediaUploadErrorEnum.MediaUploadError UNSPECIFIED
       Enum unspecified.
       
      UNSPECIFIED = 0;
    • UNKNOWN

      public static final MediaUploadErrorEnum.MediaUploadError UNKNOWN
       The received error code is not known in this version.
       
      UNKNOWN = 1;
    • FILE_TOO_BIG

      public static final MediaUploadErrorEnum.MediaUploadError FILE_TOO_BIG
       The uploaded file is too big.
       
      FILE_TOO_BIG = 2;
    • UNPARSEABLE_IMAGE

      public static final MediaUploadErrorEnum.MediaUploadError UNPARSEABLE_IMAGE
       Image data is unparseable.
       
      UNPARSEABLE_IMAGE = 3;
    • ANIMATED_IMAGE_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError ANIMATED_IMAGE_NOT_ALLOWED
       Animated images are not allowed.
       
      ANIMATED_IMAGE_NOT_ALLOWED = 4;
    • FORMAT_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError FORMAT_NOT_ALLOWED
       The image or media bundle format is not allowed.
       
      FORMAT_NOT_ALLOWED = 5;
    • EXTERNAL_URL_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError EXTERNAL_URL_NOT_ALLOWED
       Cannot reference URL external to the media bundle.
       
      EXTERNAL_URL_NOT_ALLOWED = 6;
    • INVALID_URL_REFERENCE

      public static final MediaUploadErrorEnum.MediaUploadError INVALID_URL_REFERENCE
       HTML5 ad is trying to reference an asset not in .ZIP file.
       
      INVALID_URL_REFERENCE = 7;
    • MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY

      public static final MediaUploadErrorEnum.MediaUploadError MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY
       The media bundle contains no primary entry.
       
      MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY = 8;
    • ANIMATED_VISUAL_EFFECT

      public static final MediaUploadErrorEnum.MediaUploadError ANIMATED_VISUAL_EFFECT
       Animation has disallowed visual effects.
       
      ANIMATED_VISUAL_EFFECT = 9;
    • ANIMATION_TOO_LONG

      public static final MediaUploadErrorEnum.MediaUploadError ANIMATION_TOO_LONG
       Animation longer than the allowed 30 second limit.
       
      ANIMATION_TOO_LONG = 10;
    • ASPECT_RATIO_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError ASPECT_RATIO_NOT_ALLOWED
       The aspect ratio of the image does not match the expected aspect ratios
       provided in the asset spec.
       
      ASPECT_RATIO_NOT_ALLOWED = 11;
    • AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE

      public static final MediaUploadErrorEnum.MediaUploadError AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE
       Audio files are not allowed in bundle.
       
      AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE = 12;
    • CMYK_JPEG_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError CMYK_JPEG_NOT_ALLOWED
       CMYK jpegs are not supported.
       
      CMYK_JPEG_NOT_ALLOWED = 13;
    • FLASH_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError FLASH_NOT_ALLOWED
       Flash movies are not allowed.
       
      FLASH_NOT_ALLOWED = 14;
    • FRAME_RATE_TOO_HIGH

      public static final MediaUploadErrorEnum.MediaUploadError FRAME_RATE_TOO_HIGH
       The frame rate of the video is higher than the allowed 5fps.
       
      FRAME_RATE_TOO_HIGH = 15;
    • GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED

      public static final MediaUploadErrorEnum.MediaUploadError GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED
       ZIP file from Google Web Designer is not published.
       
      GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED = 16;
    • IMAGE_CONSTRAINTS_VIOLATED

      public static final MediaUploadErrorEnum.MediaUploadError IMAGE_CONSTRAINTS_VIOLATED
       Image constraints are violated, but more details (like
       DIMENSIONS_NOT_ALLOWED or ASPECT_RATIO_NOT_ALLOWED) can not be provided.
       This happens when asset spec contains more than one constraint and
       criteria of different constraints are violated.
       
      IMAGE_CONSTRAINTS_VIOLATED = 17;
    • INVALID_MEDIA_BUNDLE

      public static final MediaUploadErrorEnum.MediaUploadError INVALID_MEDIA_BUNDLE
       Media bundle data is unrecognizable.
       
      INVALID_MEDIA_BUNDLE = 18;
    • INVALID_MEDIA_BUNDLE_ENTRY

      public static final MediaUploadErrorEnum.MediaUploadError INVALID_MEDIA_BUNDLE_ENTRY
       There was a problem with one or more of the media bundle entries.
       
      INVALID_MEDIA_BUNDLE_ENTRY = 19;
    • INVALID_MIME_TYPE

      public static final MediaUploadErrorEnum.MediaUploadError INVALID_MIME_TYPE
       The asset has an invalid mime type.
       
      INVALID_MIME_TYPE = 20;
    • INVALID_PATH

      public static final MediaUploadErrorEnum.MediaUploadError INVALID_PATH
       The media bundle contains an invalid asset path.
       
      INVALID_PATH = 21;
    • LAYOUT_PROBLEM

      public static final MediaUploadErrorEnum.MediaUploadError LAYOUT_PROBLEM
       Image has layout problem.
       
      LAYOUT_PROBLEM = 22;
    • MALFORMED_URL

      public static final MediaUploadErrorEnum.MediaUploadError MALFORMED_URL
       An asset had a URL reference that is malformed per RFC 1738 convention.
       
      MALFORMED_URL = 23;
    • MEDIA_BUNDLE_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError MEDIA_BUNDLE_NOT_ALLOWED
       The uploaded media bundle format is not allowed.
       
      MEDIA_BUNDLE_NOT_ALLOWED = 24;
    • MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE

      public static final MediaUploadErrorEnum.MediaUploadError MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE
       The media bundle is not compatible with the asset spec product type.
       (For example, Gmail, dynamic remarketing, etc.)
       
      MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE = 25;
    • MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS

      public static final MediaUploadErrorEnum.MediaUploadError MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS
       A bundle being uploaded that is incompatible with multiple assets for
       different reasons.
       
      MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS = 26;
    • TOO_MANY_FILES_IN_MEDIA_BUNDLE

      public static final MediaUploadErrorEnum.MediaUploadError TOO_MANY_FILES_IN_MEDIA_BUNDLE
       The media bundle contains too many files.
       
      TOO_MANY_FILES_IN_MEDIA_BUNDLE = 27;
    • UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT

      public static final MediaUploadErrorEnum.MediaUploadError UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT
       Google Web Designer not created for "Google Ads" environment.
       
      UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT = 28;
    • UNSUPPORTED_HTML5_FEATURE

      public static final MediaUploadErrorEnum.MediaUploadError UNSUPPORTED_HTML5_FEATURE
       Unsupported HTML5 feature in HTML5 asset.
       
      UNSUPPORTED_HTML5_FEATURE = 29;
    • URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT

      public static final MediaUploadErrorEnum.MediaUploadError URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT
       URL in HTML5 entry is not SSL compliant.
       
      URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT = 30;
    • VIDEO_FILE_NAME_TOO_LONG

      public static final MediaUploadErrorEnum.MediaUploadError VIDEO_FILE_NAME_TOO_LONG
       Video file name is longer than the 50 allowed characters.
       
      VIDEO_FILE_NAME_TOO_LONG = 31;
    • VIDEO_MULTIPLE_FILES_WITH_SAME_NAME

      public static final MediaUploadErrorEnum.MediaUploadError VIDEO_MULTIPLE_FILES_WITH_SAME_NAME
       Multiple videos with same name in a bundle.
       
      VIDEO_MULTIPLE_FILES_WITH_SAME_NAME = 32;
    • VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE

      public static final MediaUploadErrorEnum.MediaUploadError VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE
       Videos are not allowed in media bundle.
       
      VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE = 33;
    • CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API

      public static final MediaUploadErrorEnum.MediaUploadError CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API
       This type of media cannot be uploaded through the Google Ads API.
       
      CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API = 34;
    • DIMENSIONS_NOT_ALLOWED

      public static final MediaUploadErrorEnum.MediaUploadError DIMENSIONS_NOT_ALLOWED
       The dimensions of the image are not allowed.
       
      DIMENSIONS_NOT_ALLOWED = 35;
    • UNRECOGNIZED

      public static final MediaUploadErrorEnum.MediaUploadError UNRECOGNIZED
  • Field Details

    • UNSPECIFIED_VALUE

      public static final int UNSPECIFIED_VALUE
       Enum unspecified.
       
      UNSPECIFIED = 0;
      See Also:
    • UNKNOWN_VALUE

      public static final int UNKNOWN_VALUE
       The received error code is not known in this version.
       
      UNKNOWN = 1;
      See Also:
    • FILE_TOO_BIG_VALUE

      public static final int FILE_TOO_BIG_VALUE
       The uploaded file is too big.
       
      FILE_TOO_BIG = 2;
      See Also:
    • UNPARSEABLE_IMAGE_VALUE

      public static final int UNPARSEABLE_IMAGE_VALUE
       Image data is unparseable.
       
      UNPARSEABLE_IMAGE = 3;
      See Also:
    • ANIMATED_IMAGE_NOT_ALLOWED_VALUE

      public static final int ANIMATED_IMAGE_NOT_ALLOWED_VALUE
       Animated images are not allowed.
       
      ANIMATED_IMAGE_NOT_ALLOWED = 4;
      See Also:
    • FORMAT_NOT_ALLOWED_VALUE

      public static final int FORMAT_NOT_ALLOWED_VALUE
       The image or media bundle format is not allowed.
       
      FORMAT_NOT_ALLOWED = 5;
      See Also:
    • EXTERNAL_URL_NOT_ALLOWED_VALUE

      public static final int EXTERNAL_URL_NOT_ALLOWED_VALUE
       Cannot reference URL external to the media bundle.
       
      EXTERNAL_URL_NOT_ALLOWED = 6;
      See Also:
    • INVALID_URL_REFERENCE_VALUE

      public static final int INVALID_URL_REFERENCE_VALUE
       HTML5 ad is trying to reference an asset not in .ZIP file.
       
      INVALID_URL_REFERENCE = 7;
      See Also:
    • MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY_VALUE

      public static final int MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY_VALUE
       The media bundle contains no primary entry.
       
      MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY = 8;
      See Also:
    • ANIMATED_VISUAL_EFFECT_VALUE

      public static final int ANIMATED_VISUAL_EFFECT_VALUE
       Animation has disallowed visual effects.
       
      ANIMATED_VISUAL_EFFECT = 9;
      See Also:
    • ANIMATION_TOO_LONG_VALUE

      public static final int ANIMATION_TOO_LONG_VALUE
       Animation longer than the allowed 30 second limit.
       
      ANIMATION_TOO_LONG = 10;
      See Also:
    • ASPECT_RATIO_NOT_ALLOWED_VALUE

      public static final int ASPECT_RATIO_NOT_ALLOWED_VALUE
       The aspect ratio of the image does not match the expected aspect ratios
       provided in the asset spec.
       
      ASPECT_RATIO_NOT_ALLOWED = 11;
      See Also:
    • AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE_VALUE

      public static final int AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE_VALUE
       Audio files are not allowed in bundle.
       
      AUDIO_NOT_ALLOWED_IN_MEDIA_BUNDLE = 12;
      See Also:
    • CMYK_JPEG_NOT_ALLOWED_VALUE

      public static final int CMYK_JPEG_NOT_ALLOWED_VALUE
       CMYK jpegs are not supported.
       
      CMYK_JPEG_NOT_ALLOWED = 13;
      See Also:
    • FLASH_NOT_ALLOWED_VALUE

      public static final int FLASH_NOT_ALLOWED_VALUE
       Flash movies are not allowed.
       
      FLASH_NOT_ALLOWED = 14;
      See Also:
    • FRAME_RATE_TOO_HIGH_VALUE

      public static final int FRAME_RATE_TOO_HIGH_VALUE
       The frame rate of the video is higher than the allowed 5fps.
       
      FRAME_RATE_TOO_HIGH = 15;
      See Also:
    • GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED_VALUE

      public static final int GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED_VALUE
       ZIP file from Google Web Designer is not published.
       
      GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED = 16;
      See Also:
    • IMAGE_CONSTRAINTS_VIOLATED_VALUE

      public static final int IMAGE_CONSTRAINTS_VIOLATED_VALUE
       Image constraints are violated, but more details (like
       DIMENSIONS_NOT_ALLOWED or ASPECT_RATIO_NOT_ALLOWED) can not be provided.
       This happens when asset spec contains more than one constraint and
       criteria of different constraints are violated.
       
      IMAGE_CONSTRAINTS_VIOLATED = 17;
      See Also:
    • INVALID_MEDIA_BUNDLE_VALUE

      public static final int INVALID_MEDIA_BUNDLE_VALUE
       Media bundle data is unrecognizable.
       
      INVALID_MEDIA_BUNDLE = 18;
      See Also:
    • INVALID_MEDIA_BUNDLE_ENTRY_VALUE

      public static final int INVALID_MEDIA_BUNDLE_ENTRY_VALUE
       There was a problem with one or more of the media bundle entries.
       
      INVALID_MEDIA_BUNDLE_ENTRY = 19;
      See Also:
    • INVALID_MIME_TYPE_VALUE

      public static final int INVALID_MIME_TYPE_VALUE
       The asset has an invalid mime type.
       
      INVALID_MIME_TYPE = 20;
      See Also:
    • INVALID_PATH_VALUE

      public static final int INVALID_PATH_VALUE
       The media bundle contains an invalid asset path.
       
      INVALID_PATH = 21;
      See Also:
    • LAYOUT_PROBLEM_VALUE

      public static final int LAYOUT_PROBLEM_VALUE
       Image has layout problem.
       
      LAYOUT_PROBLEM = 22;
      See Also:
    • MALFORMED_URL_VALUE

      public static final int MALFORMED_URL_VALUE
       An asset had a URL reference that is malformed per RFC 1738 convention.
       
      MALFORMED_URL = 23;
      See Also:
    • MEDIA_BUNDLE_NOT_ALLOWED_VALUE

      public static final int MEDIA_BUNDLE_NOT_ALLOWED_VALUE
       The uploaded media bundle format is not allowed.
       
      MEDIA_BUNDLE_NOT_ALLOWED = 24;
      See Also:
    • MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE_VALUE

      public static final int MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE_VALUE
       The media bundle is not compatible with the asset spec product type.
       (For example, Gmail, dynamic remarketing, etc.)
       
      MEDIA_BUNDLE_NOT_COMPATIBLE_TO_PRODUCT_TYPE = 25;
      See Also:
    • MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS_VALUE

      public static final int MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS_VALUE
       A bundle being uploaded that is incompatible with multiple assets for
       different reasons.
       
      MEDIA_BUNDLE_REJECTED_BY_MULTIPLE_ASSET_SPECS = 26;
      See Also:
    • TOO_MANY_FILES_IN_MEDIA_BUNDLE_VALUE

      public static final int TOO_MANY_FILES_IN_MEDIA_BUNDLE_VALUE
       The media bundle contains too many files.
       
      TOO_MANY_FILES_IN_MEDIA_BUNDLE = 27;
      See Also:
    • UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT_VALUE

      public static final int UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT_VALUE
       Google Web Designer not created for "Google Ads" environment.
       
      UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT = 28;
      See Also:
    • UNSUPPORTED_HTML5_FEATURE_VALUE

      public static final int UNSUPPORTED_HTML5_FEATURE_VALUE
       Unsupported HTML5 feature in HTML5 asset.
       
      UNSUPPORTED_HTML5_FEATURE = 29;
      See Also:
    • URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT_VALUE

      public static final int URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT_VALUE
       URL in HTML5 entry is not SSL compliant.
       
      URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT = 30;
      See Also:
    • VIDEO_FILE_NAME_TOO_LONG_VALUE

      public static final int VIDEO_FILE_NAME_TOO_LONG_VALUE
       Video file name is longer than the 50 allowed characters.
       
      VIDEO_FILE_NAME_TOO_LONG = 31;
      See Also:
    • VIDEO_MULTIPLE_FILES_WITH_SAME_NAME_VALUE

      public static final int VIDEO_MULTIPLE_FILES_WITH_SAME_NAME_VALUE
       Multiple videos with same name in a bundle.
       
      VIDEO_MULTIPLE_FILES_WITH_SAME_NAME = 32;
      See Also:
    • VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE_VALUE

      public static final int VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE_VALUE
       Videos are not allowed in media bundle.
       
      VIDEO_NOT_ALLOWED_IN_MEDIA_BUNDLE = 33;
      See Also:
    • CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API_VALUE

      public static final int CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API_VALUE
       This type of media cannot be uploaded through the Google Ads API.
       
      CANNOT_UPLOAD_MEDIA_TYPE_THROUGH_API = 34;
      See Also:
    • DIMENSIONS_NOT_ALLOWED_VALUE

      public static final int DIMENSIONS_NOT_ALLOWED_VALUE
       The dimensions of the image are not allowed.
       
      DIMENSIONS_NOT_ALLOWED = 35;
      See Also:
  • Method Details

    • values

      public static MediaUploadErrorEnum.MediaUploadError[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static MediaUploadErrorEnum.MediaUploadError valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null
    • getNumber

      public final int getNumber()
      Specified by:
      getNumber in interface com.google.protobuf.Internal.EnumLite
      Specified by:
      getNumber in interface com.google.protobuf.ProtocolMessageEnum
    • valueOf

      @Deprecated public static MediaUploadErrorEnum.MediaUploadError valueOf(int value)
      Deprecated.
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      value - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null
    • forNumber

      public static MediaUploadErrorEnum.MediaUploadError forNumber(int value)
      Parameters:
      value - The numeric wire value of the corresponding enum entry.
      Returns:
      The enum associated with the given numeric wire value.
    • internalGetValueMap

      public static com.google.protobuf.Internal.EnumLiteMap<MediaUploadErrorEnum.MediaUploadError> internalGetValueMap()
    • getValueDescriptor

      public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()
      Specified by:
      getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnum
    • getDescriptorForType

      public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnum
    • getDescriptor

      public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()
    • valueOf

      public static MediaUploadErrorEnum.MediaUploadError valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      desc - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null